DosSubFreeMem |
DOS : Sous libération de mémoire |
|---|---|
| DOSCALLS.DLL | os2.h |
Syntaxe
| APIRET DosSubFreeMem( PVOID pOffset, PVOID pBlockOffset, ULONG ulSize ); |
Paramètres
| Nom | Description |
|---|---|
| pOffset | Ce paramètre permet d'indiquer la position en mémoire du pool dans lequel le bloc de mémoire est libérer. |
| pBlockOffset | Ce paramètre contient la position du bloc de mémoire à libérer. |
| ulSize | Ce paramètre permet d'indiquer la taille, en octets, du bloc mémoire à libérer. |
Retour
| Valeur | Constante | Description |
|---|---|---|
| 0 | NO_ERROR | Cette valeur permet d'indiquer que l'opération s'est correctement effectué |
| 87 | ERROR_INVALID_PARAMETER | Cette valeur permet d'indiquer qu'un ou plusieurs des paramètres contient une valeur illégale. |
| 312 | ERROR_DOSSUB_OVERLAP | Cette valeur permet d'indiquer qu'une erreur de sous mémoire overlap s'est produite. |
| 532 | ERROR_DOSSUB_CORRUPTED | Cette valeur permet d'indiquer qu'il y a corruption de sous-mémoire. |
Description
Cette fonction permet d'allouer un bloc de mémoire d'un pool de création utilisant DosSubSetMem.
Exemple
Voici un simple exemple montrant comme appeler cette API avec WatCom C++ for OS/2 :
- #define INCL_DOSERRORS
- #define INCL_DOSMEMMGR
- #include "os2.h"
- #include "stdio.h"
-
- void main(void) {
- PVOID Offset;
- PVOID BlockOffset;
- switch(DosSubFreeMem( Offset, BlockOffset, 128)) {
- case NO_ERROR: printf("Tout va bien !");break;
- case ERROR_NOT_ENOUGH_MEMORY: printf("Erreur : La limite de mémoire système est atteinte.");break;
- case ERROR_INVALID_PARAMETER: printf("Erreur : Un ou plusieurs des paramètres contient une valeur illégale.");break;
- case ERROR_DOSSUB_OVERLAP: printf("Erreur : une erreur de sous mémoire overlap s'est produite.");break;
- case ERROR_DOSSUB_CORRUPTED: printf("Erreur : Il y a corruption de sous-mémoire.");break;
- }
- }
Voir également
Langage de programmation - C pour OS/2 - DosSubAllocMem
Langage de programmation - C pour OS/2 - DosSubSetMem
Langage de programmation - C pour OS/2 - DosSubUnsetMem
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010