HeapVidMemAllocAligned, fonction (dmemmgr.h)
La fonction HeapVidMemAllocAligned alloue off_screen_memory pour un pilote d’affichage à l’aide du gestionnaire de tas de mémoire vidéo DirectDraw.
Syntaxe
FLATPTR HeapVidMemAllocAligned(
[in] LPVIDMEM lpVidMem,
[in] DWORD dwWidth,
[in] DWORD dwHeight,
[in] LPSURFACEALIGNMENT lpAlignment,
[out] LPLONG lpNewPitch
);
Paramètres
[in] lpVidMem
Pointeur vers une structure VIDEOMEMORY qui représente le tas DirectDraw à partir duquel allouer la surface.
[in] dwWidth
Largeur en octets de la surface demandée.
[in] dwHeight
Hauteur dans les lignes de balayage de la surface demandée.
[in] lpAlignment
Pointeur vers une structure SURFACEALIGNMENT qui décrit les restrictions d’alignement pour la surface.
[out] lpNewPitch
Emplacement dans lequel la valeur de pitch obtenue est écrite. Ces informations concernent uniquement les tas hors écran linéaires (nonrectangulaires).
Valeur retournée
HeapVidMemAllocAligned retourne le décalage FLATPTR de l’allocation résultante en cas de réussite. Sinon, elle retourne zéro.
Notes
Le pilote doit utiliser le tableau des structures VIDEOMEMORY que sa fonction DrvGetDirectDrawInfo reçoit pour déterminer la valeur de lpVidMem avec laquelle appeler HeapVidMemAllocAligned. Le pilote reçoit ce tableau dans le paramètre pvmList lors du deuxième appel à DrvGetDirectDrawInfo. Il est possible que DrvGetDirectDrawInfo ne soit pas appelé lorsque des conditions de mémoire insuffisantes existent sur le système. Par conséquent, le pilote doit toujours case activée pour s’assurer qu’il a un pointeur non NULL dans pvmList.
Spécifications
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | dmemmgr.h (incluez Winddi.h) |
| Bibliothèque | Win32k.lib |
| DLL | Win32k.sys |