Nom |
Description |
uFlags |
Ce paramètre permet d'indiquer comment allouer de la mémoire. Si la valeur 0 est spécifiée, la valeur par défaut est le drapeau LMEM_FIXED. À l'exception des combinaisons
incompatibles étant spécifiquement notées, toute combinaison des drapeaux suivants peut être spécifiée. Pour indiquer si la fonction alloue de la mémoire fixe ou mobile, spécifiez l'un des 6
premiers drapeaux : |
LMEM_FIXED |
Cette valeur permet d'allouer de la mémoire fixe. Ce drapeau ne peut pas être combiné avec les drapeaux LMEM_MOVEABLE ou LMEM_DISCARDABLE. La valeur de retour est un pointeur sur le bloc de mémoire. Pour accéder à la mémoire, le processus appelant convertit simplement la valeur de retour en un pointeur. |
LMEM_MOVEABLE |
Cette valeur permet d'allouer de la mémoire déplaçable. Ce drapeau ne peut pas être combiné avec le drapeau LMEM_FIXED. La valeur de retour est l'identificateur de l'objet de la mémoire. Le descripteur est une quantité 32 bits privée du processus appelant. Pour convertir l'identificateur en un pointeur, utilisez la fonction LocalLock. |
LPTR |
Cette valeur permet de combiner les drapeaux LMEM_FIXED et LMEM_ZEROINIT. |
LHND |
Cette valeur permet de combiner les drapeaux LMEM_MOVEABLE et LMEM_ZEROINIT. |
NONZEROLHND |
Cette valeur permet d'allouer de la mémoire déplaçable. Ce drapeau ne peut pas être combiné avec le drapeau LMEM_FIXED. La valeur de retour est l'identificateur de l'objet de la mémoire. Le descripteur est une quantité 32 bits privée du processus appelant. Pour convertir l'identificateur en un pointeur, utilisez la fonction LocalLock. |
NONZEROLPTR |
Cette valeur permet d'allouer de la mémoire fixe. Ce drapeau ne peut pas être combiné avec les drapeaux LMEM_MOVEABLE ou LMEM_DISCARDABLE. La valeur de retour est un pointeur sur le bloc de mémoire. Pour accéder à la mémoire, le processus appelant convertit simplement la valeur de retour en un pointeur. |
LMEM_DISCARDABLE |
Cette valeur permet d'allouer la mémoire jetable. Ce drapeau ne peut pas être combiné avec le drapeau LMEM_FIXED. Certaines applications Win32 peuvent ignorer ce drapeau. |
LMEM_NOCOMPACT |
Cette valeur permet de ne pas compresser ou ne pas supprimer la mémoire pour satisfaire la demande d'allocation. |
LMEM_NODISCARD |
Cette valeur permet de ne pas supprimer la mémoire pour satisfaire la demande d'allocation. |
LMEM_ZEROINIT |
Cette valeur permet d'initialiser le contenu de la mémoire à 0. |
uBytes |
Ce paramètre permet d'indiquer le nombre d'octets à allouer. Si ce paramètre est égal à 0 et que le paramètre uFlags spécifie le drapeau LMEM_MOVEABLE, la fonction renvoie un descripteur à un objet mémoire marqué comme étant ignoré. |
Cette fonction permet d'allouer le nombre d'octets spécifiés pour le tas local.