Langage de programmation - C pour OS/2 - Référence de procédures et de fonctions

DosAllocShrSeg	DOS : Alloue un partage de segment
DOSCALLS.DLL	os2.h

USHORT DosAllocShrSeg(USHORT Size, PSZ Name, PSEL Selector);

Nom	Description
Size	Ce paramètre permet d'indiquer le nombre d'octets requis.
Name	Ce paramètre permet d'indiquer l'adresse de la chaîne de caractères contenant le nom associé avec le segment de mémoire partagé devant être alloué.
Selector	Ce paramètre permet d'indiquer l'adresse où le sélecteur alloué le segment à retourner.

Valeur	Constante	Description
0	NO_ERROR	Cette valeur permet d'indiquer que l'opération s'est correctement effectué
8	ERROR_NOT_ENOUGH_MEMORY	Cette valeur permet d'indiquer que la limite de mémoire système est atteinte.
123	ERROR_INVALID_NAME	Cette valeur permet d'indiquer qu'une erreur de nom invalide s'est produite.
183	ERROR_ALREADY_EXISTS	Cette valeur permet d'indiquer qu'une erreur de nom déjà existante s'est produite.

Cette fonction permet d'allouer un segment de mémoire partagé nommé.

La fonction DosAllocShrSeg alloue un segment nommé d'une taille maximale de 64 Ko, pouvant être déplacé et échangé. Le segment peut être partagé par tout processus connaissant le nom du segment.
Pour accéder au segment partagé, un autre processus émet un appel à la fonction DosGetShrSeg, en spécifiant le nom du segment. Le sélecteur renvoyé par la fonction DosGetShrSeg est le même que celui renvoyé par DosAllocShrSeg.
Le nombre maximal de segments qu'un processus peut définir avec la fonction DosAllocShrSeg ou l'accès avec la fonction DosGetShrSeg est de 256.
Cette requête peut être émise à partir du niveau de privilège 2. Cependant, le segment est alloué en tant que segment de niveau de privilège 3.

Dernière mise à jour : Lundi, le 19 juillet 2010

Section courante