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 指標。

需求

另請參閱

DrvGetDirectDrawInfo

SURFACEALIGNMENT

VIDEOMEMORY

VidMemFree