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 |