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

표면을 할당할 DirectDraw 힙을 나타내는 VIDEOMEMORY 구조체에 대한 포인터입니다.

[in] dwWidth

요청된 표면의 너비(바이트)입니다.

[in] dwHeight

요청된 표면의 스캔 라인의 높이입니다.

[in] lpAlignment

표면의 맞춤 제한을 설명하는 SURFACEALIGNMENT 구조체에 대한 포인터입니다.

[out] lpNewPitch

결과 피치 값이 기록되는 위치입니다. 이 정보는 화면 외의 선형(비사각형) 힙과만 관련이 있습니다.

반환 값

HeapVidMemAllocAligned는 성공 시 결과 할당의 FLATPTR 오프셋을 반환합니다. 그렇지 않으면 0을 반환합니다.

설명

드라이버는 DrvGetDirectDrawInfo 함수가 수신하는 VIDEOMEMORY 구조의 배열을 사용하여 HeapVidMemAllocAligned를 호출할 lpVidMem 값을 결정해야 합니다. 드라이버는 DrvGetDirectDrawInfo에 대한 두 번째 호출 중에 pvmList 매개 변수에서 이 배열을 받습니다. 시스템에 메모리 조건이 부족한 경우 DrvGetDirectDrawInfo 가 호출되지 않을 수 있습니다. 따라서 드라이버는 항상 pvmList에 NULL이 아닌 포인터가 있는지 확인하기 위해 검사 합니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	dmemmgr.h(Winddi.h 포함)
라이브러리	Win32k.lib
DLL	Win32k.sys

추가 정보

DrvGetDirectDrawInfo

SURFACEALIGNMENT

VIDEOMEMORY

VidMemFree