DXGKDDI_DESCRIBEALLOCATION 콜백 함수(d3dkmddi.h)

아티클
05/26/2023

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 을 페이징 가능으로 만들어야 합니다.