HeapVidMemAllocAligned-Funktion (dmemmgr.h)
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 |