HeapVidMemAllocAligned-Funktion (dmemmgr.h)

Artikel
08/23/2023

Die HeapVidMemAllocAligned-Funktion ordnet off_screen_memory einem Anzeigetreiber mithilfe des DirectDraw-Videospeicherheap-Managers zu.

Syntax

FLATPTR HeapVidMemAllocAligned(
  [in]  LPVIDMEM           lpVidMem,
  [in]  DWORD              dwWidth,
  [in]  DWORD              dwHeight,
  [in]  LPSURFACEALIGNMENT lpAlignment,
  [out] LPLONG             lpNewPitch
);

Parameter

[in] lpVidMem

Zeiger auf eine VIDEOMEMORY-Struktur , die den DirectDraw-Heap darstellt, von dem die Oberfläche zugeordnet werden soll.

[in] dwWidth

Die Breite der angeforderten Oberfläche in Byte.

[in] dwHeight

Die Höhe in Scanlinien der angeforderten Oberfläche.

[in] lpAlignment

Zeiger auf eine SURFACEALIGNMENT-Struktur , die die Ausrichtungseinschränkungen für die Oberfläche beschreibt.

[out] lpNewPitch

Der Ort, an dem der resultierende Tonhöhenwert geschrieben wird. Diese Informationen sind nur für lineare (nicht-ectangulare) Off-Screen-Heaps relevant.

Rückgabewert

HeapVidMemAllocAligned gibt bei Erfolg den FLATPTR-Offset der resultierenden Zuordnung zurück. Andernfalls wird null zurückgegeben.

Hinweise

Der Treiber sollte das Array von VIDEOMEMORY-Strukturen verwenden, das seine DrvGetDirectDrawInfo-Funktion empfängt, um den Wert von lpVidMem zu bestimmen, mit dem HeapVidMemAllocAligned aufgerufen werden soll. Der Treiber empfängt dieses Array im pvmList-Parameter während des zweiten Aufrufs von DrvGetDirectDrawInfo. Es ist möglich, dass DrvGetDirectDrawInfo möglicherweise nicht aufgerufen wird, wenn auf dem System geringe Arbeitsspeicherbedingungen vorhanden sind. Daher sollte der Treiber immer überprüfen, ob er in pvmList über einen Zeiger ungleich NULL verfügt.

Anforderungen


Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	dmemmgr.h (include Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys

Weitere Informationen

Share via