共用方式為


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 結構陣列來判斷要呼叫HeapVidMemAllocAlignedlpVidMem值。 驅動程式在第二次呼叫DrvGetDirectDrawInfo時,會在pvmList參數中收到此陣列。 當系統上存在低記憶體狀況時,可能不會呼叫 DrvGetDirectDrawInfo 。 因此,驅動程式應該一律檢查以確保它在 pvmList中有非 Null 指標。

需求

   
最低支援的用戶端 適用于 Windows 2000 和更新版本的 Windows 作業系統。
目標平台 Universal
標頭 dmemmgr.h (包含 Winddi.h)
程式庫 Win32k.lib
Dll Win32k.sys

另請參閱

DrvGetDirectDrawInfo

SURFACEALIGNMENT

VIDEOMEMORY

VidMemFree