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