DXGKCB_AGP_ALLOCATE_POOL 콜백 함수(dispmprt.h)

DXGKCB_AGP_ALLOCATE_POOL 콜백 함수는 AGP(가속 그래픽 포트) 메모리를 예약, 커밋 및 매핑합니다.

통사론

DXGKCB_AGP_ALLOCATE_POOL DxgkcbAgpAllocatePool;

NTSTATUS DxgkcbAgpAllocatePool(
  [in]  IN HANDLE Context,
  [in]  IN ULONG AllocationSize,
  [in]  IN MEMORY_CACHING_TYPE CacheType,
  [out] OUT PPHYSICAL_ADDRESS PhysicalAddress,
  [out] OUT PVOID *VirtualAddress
)
{...}

매개 변수

[in] Context

AGP 인터페이스와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DxgkCbQueryServices채워진 DXGK_AGP_INTERFACE 구조의 Context 멤버에서 이 핸들을 받았습니다.

[in] AllocationSize

할당할 AGP 메모리의 크기(바이트)입니다.

[in] CacheType

CPU가 할당된 AGP 메모리에 액세스할 때 캐싱 또는 쓰기 결합을 사용할 수 있는지 여부를 지정하는 MEMORY_CACHING_TYPE 열거형의 상수입니다.

[out] PhysicalAddress

AGP 할당의 기본 물리적 주소를 수신하는 PHYSICAL_ADDRESS 구조체에 대한 포인터입니다. GPU가 AGP 메모리에 액세스하는 데 사용하는 실제 주소 범위의 기준입니다.

[out] VirtualAddress

AGP 할당의 기본 가상 주소(시스템 공간)를 수신하는 변수에 대한 포인터입니다. 이는 CPU가 AGP 메모리에 액세스하는 데 사용하는 가상 주소 범위의 기반입니다.

반환 값

AgpAllocatePool 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ntstatus.h정의된 오류 코드 중 하나를 반환합니다.

발언

디스플레이 미니포트 드라이버의 DxgkDdiStartDevice 함수에서 AgpAllocatePool 호출합니다. DxgkDdiStartDevice 실행한 후에 호출하면 AgpAllocatePool 실패할 수 있습니다.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista
대상 플랫폼	바탕 화면
헤더	dispmprt.h(Dispmprt.h 포함)
IRQL	PASSIVE_LEVEL

참고 항목

AgpFreePool

agpSetCommand

DXGK_AGP_INTERFACE

DxgkCbQueryServices