VideoPortAllocatePool 함수(video.h)
VideoPortAllocatePool 함수는 풀 메모리 블록을 할당하여 호출자가 제공한 태그를 메모리의 시작 부분에 삽입합니다.
구문
VIDEOPORT_API PVOID VideoPortAllocatePool(
[in] IN PVOID HwDeviceExtension,
[in] IN VP_POOL_TYPE PoolType,
[in] IN SIZE_T NumberOfBytes,
[in] IN ULONG Tag
);
매개 변수
[in] HwDeviceExtension
미니포트 드라이버의 디바이스 확장에 대한 포인터입니다.
[in] PoolType
할당할 메모리 풀의 유형을 지정합니다. 이 매개 변수는 다음 중 하나로 설정할 수 있습니다.
값 | 의미 |
---|---|
VpNonPagedPool | 풀은 페이지가 없는 메모리에서 가져옵니다. |
VpPagedPool | 풀은 페이징된 메모리에서 가져옵니다. |
VpNonPagedPoolCacheAligned | 풀은 캐시 정렬되지 않은 메모리에서 가져옵니다. |
VpPagedPoolCacheAligned | 풀은 캐시 정렬 페이징 메모리에서 가져옵니다. |
[in] NumberOfBytes
할당할 메모리의 바이트 수를 지정합니다.
[in] Tag
메모리를 할당하는 드라이버를 고유하게 식별하는 최대 4개의 ASCII 문자로 구성된 4바이트 할당 태그를 지정합니다. 태그 문자열은 작은따옴표로 구분됩니다.
반환 값
메모리 풀을 성공적으로 할당하면 VideoPortAllocatePool 은 할당된 메모리 풀의 주소를 반환합니다. 그렇지 않으면 이 함수는 NULL을 반환합니다.
설명
VideoPortAllocatePool 은 사용되지 않는 VideoPortAllocateBuffer를 대체하기 위한 것입니다.
태그 문자열은 바이트 반전 순서로 지정해야 합니다. 표시 드라이버를 나타내려면 문자열의 첫 글자(반전되기 전)를 'D'로 지정하는 것이 좋습니다. 나머지 3바이트는 드라이버 이름을 나타내야 합니다. 예를 들어 풀이 덤프되면 태그 문자열 'zyxD'가 'Dxyz'로 표시됩니다. 태그는 발생하는 시스템의 크래시 덤프에 표시됩니다.
VideoPortAllocatePool의 호출자는 요청된 PoolType이 VpNonPagedXxx 형식 중 하나인 경우에만 IRQL = DISPATCH_LEVEL 실행할 수 있습니다. 그렇지 않으면 호출자가 IRQL < DISPATCH_LEVEL 실행 중이어야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
대상 플랫폼 | 데스크톱 |
머리글 | video.h(Video.h 포함) |
라이브러리 | Videoprt.lib |
DLL | Videoprt.sys |
IRQL | 설명 섹션을 참조하십시오. |