DXGKDDI_QUERY_CHILD_RELATIONS 콜백 함수(dispmprt.h)

DxgkDdiQueryChildRelations 함수는 디스플레이 어댑터의 자식 디바이스를 열거합니다.

구문

DXGKDDI_QUERY_CHILD_RELATIONS DxgkddiQueryChildRelations;

NTSTATUS DxgkddiQueryChildRelations(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] PDXGK_CHILD_DESCRIPTOR ChildRelations,
  [in]      ULONG ChildRelationsSize
)
{...}

매개 변수

[in] MiniportDeviceContext

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

[in, out] ChildRelations

호출자가 할당하고 0으로 설정한 DXGK_CHILD_DESCRIPTOR 구조체 배열에 대한 포인터입니다. 배열의 요소 수는 NumberOfChildren 매개 변수에서 DxgkDdiStartDevice가 반환한 값보다 1보다 큽니다. DxgkDdiQueryChildRelations 는 배열의 마지막 구조를 제외한 모든 구조를 디스플레이 어댑터의 자식 디바이스를 설명하는 정보로 채워야 합니다. 배열의 마지막 구조체는 0으로 유지되어야 합니다.

[in] ChildRelationsSize

끝에 있는 0 구조체를 포함하여 ChildRelations 배열의 총 크기(바이트)입니다.

반환 값

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

설명

디스플레이 어댑터의 모든 자식 디바이스가 온보딩됩니다. 디스플레이 어댑터에 연결하는 모니터 및 기타 외부 디바이스는 자식 디바이스로 간주되지 않습니다.

디스플레이 미니포트 드라이버는 각 디스플레이 어댑터의 자식에 대해 하나씩 DXGK_CHILD_DESCRIPTOR 구조체 배열을 채워야 합니다. 배열에는 모든 현재 자식 디바이스 및 모든 잠재적 자식 디바이스에 대한 DXGK_CHILD_DESCRIPTOR 구조가 포함되어야 합니다. 예를 들어 이식 가능한 컴퓨터를 도킹하면 새 비디오 출력을 사용할 수 있게 되는 경우 해당 비디오 출력에는 현재 사용할 수 없는 경우에도 배열에 설명자가 있어야 합니다.

DxgkDdiQueryChildRelations 함수를 페이징 가능으로 만들어야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	dispmprt.h
IRQL	PASSIVE_LEVEL

추가 정보

DXGK_CHILD_DESCRIPTOR

DXGK_CHILD_STATUS

DxgkDdiQueryChildStatus

DxgkDdiQueryDeviceDescriptor