DXGKDDI_DESCRIBEALLOCATION 콜백 함수(d3dkmddi.h)

아티클
02/06/2025

DxgkDdiDescribeAllocation 함수는 Microsoft DirectX 그래픽 커널 하위 시스템에 사용할 수 없는 기존 할당에 대한 정보를 검색합니다.

통사론

DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;

NTSTATUS DxgkddiDescribeallocation(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_DESCRIBEALLOCATION pDescribeAllocation
)
{...}

매개 변수

[in] hAdapter

디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DxgkDdiAddDevice 함수의 MiniportDeviceContext 출력 매개 변수의 DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.

[in/out] pDescribeAllocation

기존 할당을 설명하는 DXGKARG_DESCRIBEALLOCATION 구조체에 대한 포인터입니다.

반환 값

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

발언

DirectX 그래픽 커널 하위 시스템이 반드시 할당 레코드를 유지 관리하는 것은 아니므로 그래픽 커널 하위 시스템은 DxgkDdiDescribeAllocation 호출하여 디스플레이 미니포트 드라이버가 기존 할당에 대한 정보를 반환하도록 요청합니다. 현재 디스플레이 미니포트 드라이버는 다음 할당에 대해 이 정보를 반환할 수 있어야 합니다.

주 데이터베이스인 할당(즉, pfnAllocateCb 함수에 대한 호출에서 D3DDDI_ALLOCATIONINFO 구조체의 Flags 멤버에서 기본 비트 필드 플래그를 설정하여 만든 사용자 모드 표시 드라이버 할당).
프레젠테이션의 원본일 수 있는 할당(즉, 디스플레이 미니포트 드라이버의 DxgkDdiPresent 함수를 호출할 때 DXGKARG_PRESENT 구조체의 hSource 멤버가 나타내는 할당).

DxgkDdiDescribeAllocation 페이징할 수 있어야 합니다.