HeapVidMemAllocAligned, fonction (dmemmgr.h)

Article
08/23/2023

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

Voir aussi

Partager via