DXGKCB_ENUMHANDLECHILDREN 콜백 함수(d3dkmddi.h)

DXGKCB_ENUMHANDLECHILDREN 지정된 리소스와 연결된 할당을 한 번에 하나씩 열거합니다.

구문

DXGKCB_ENUMHANDLECHILDREN DxgkcbEnumhandlechildren;

D3DKMT_HANDLE DxgkcbEnumhandlechildren(
  [in] IN_CONST_PDXGKARGCB_ENUMHANDLECHILDREN unnamedParam1
)
{...}

매개 변수

[in] unnamedParam1

검색할 자식 할당의 부모 리소스 및 인덱스를 설명하는 DXGKARGCB_ENUMHANDLECHILDREN 구조체에 대한 포인터입니다.

반환 값

DXGKCB_ENUMHANDLECHILDRENpData에서 설명하는 자식 할당에 대한 Dxgkrnl 관련 핸들을 반환합니다. 핸들에 대한 디바이스별 데이터를 검색하려면 디스플레이 미니포트 드라이버가 DXGKCB_GETHANDLEDATA 함수를 호출해야 합니다.

DXGKCB_ENUMHANDLECHILDREN DXGKARGCB_ENUMHANDLECHILDREN구조체의 Index 멤버에 제공된 자식 할당 인덱스 값이 부모 리소스와 연결된 할당 수를 초과하면 NULL 핸들을 반환합니다. DXGKCB_ENUMHANDLECHILDREN 예기치 않게 NULL 핸들을 반환하는 경우 DirectX 그래픽 커널 하위 시스템은 다음과 같은 이유로 핸들을 부모 리소스에 resolve 수 없습니다.

• 악의적인 공격이나 다른 버그로 인해 사용자 모드 디스플레이 드라이버에서 잘못된 핸들을 수신했습니다.
• 할당에는 수명 문제가 있었습니다.

NULL 핸들이 예기치 않게 반환되면 디스플레이 미니포트 드라이버가 STATUS_INVALID_HANDLE 현재 실행 중인 DDI 함수에 실패해야 합니다.

설명

디스플레이 미니포트 드라이버는 루프에서 DXGKCB_ENUMHANDLECHILDREN 호출하여 리소스와 연결된 모든 할당을 열거할 수 있습니다.

할당 핸들 인덱스는 0부터 시작합니다. 디스플레이 미니포트 드라이버가 pData-Index>를 0으로 설정하면 DXGKCB_ENUMHANDLECHILDREN 첫 번째 할당 핸들을 반환합니다. Index가 1로 설정된 경우 DXGKCB_ENUMHANDLECHILDREN 두 번째 할당 핸들을 반환하는 등입니다. Index가 리소스와 연결된 할당 수보다 크면 DXGKCB_ENUMHANDLECHILDRENNULL을 반환합니다.

DXGKCB_XXX 함수는 Dxgkrnl에 의해 구현됩니다. 이 콜백 함수를 사용하려면 DXGKARGCB_ENUMHANDLECHILDREN 적절한 멤버를 설정한 다음, DXGKRNL_INTERFACE 통해 DxgkCbEnumHandleChildren를 호출합니다.

요구 사항

추가 정보

DXGKARGCB_ENUMHANDLECHILDREN

DXGKCB_GETHANDLEDATA

DXGKRNL_INTERFACE