heapVidMemAllocAligned 函式 (dmemmgr.h)
HeapVidMemAllocAligned 函式會使用 DirectDraw 視訊記憶體堆積管理員,為顯示驅動程式配置off_screen_memory。
語法
FLATPTR HeapVidMemAllocAligned(
[in] LPVIDMEM lpVidMem,
[in] DWORD dwWidth,
[in] DWORD dwHeight,
[in] LPSURFACEALIGNMENT lpAlignment,
[out] LPLONG lpNewPitch
);
參數
[in] lpVidMem
VIDEOMEMORY結構的指標,代表要配置介面的來源 DirectDraw 堆積。
[in] dwWidth
這是所要求表面的位元組寬度。
[in] dwHeight
這是所要求表面掃描行的高度。
[in] lpAlignment
SURFACEALIGNMENT結構的指標,描述表面的對齊限制。
[out] lpNewPitch
這是寫入結果音調值的位置。 這項資訊僅與非螢幕外堆積 (非矩形式) 相關。
傳回值
HeapVidMemAllocAligned 會在成功時傳回結果配置的 FLATPTR 位移。 否則,它會傳回零。
備註
驅動程式應該使用其DrvGetDirectDrawInfo 函式接收的 VIDEOMEMORY 結構陣列來判斷要呼叫HeapVidMemAllocAligned的lpVidMem值。 驅動程式在第二次呼叫DrvGetDirectDrawInfo時,會在pvmList參數中收到此陣列。 當系統上存在低記憶體狀況時,可能不會呼叫 DrvGetDirectDrawInfo 。 因此,驅動程式應該一律檢查以確保它在 pvmList中有非 Null 指標。
需求
最低支援的用戶端 | 適用于 Windows 2000 和更新版本的 Windows 作業系統。 |
目標平台 | Universal |
標頭 | dmemmgr.h (包含 Winddi.h) |
程式庫 | Win32k.lib |
Dll | Win32k.sys |