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 |
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | dispmprt.h |
| IRQL | PASSIVE_LEVEL |