DXGKDDI_QUERY_CHILD_STATUS 콜백 함수(dispmprt.h)

아티클
05/23/2024

DxgkDdiQueryChildStatus 함수는 디스플레이 어댑터의 개별 자식 디바이스의 상태 반환합니다.

구문

DXGKDDI_QUERY_CHILD_STATUS DxgkddiQueryChildStatus;

NTSTATUS DxgkddiQueryChildStatus(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] INOUT_PDXGK_CHILD_STATUS ChildStatus,
  [in]      IN_BOOLEAN NonDestructiveOnly
)
{...}

매개 변수

[in] MiniportDeviceContext

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

[in, out] ChildStatus

DXGK_CHILD_STATUS 구조체에 대한 포인터입니다. 호출자는 ChildStatus-Type> 및 ChildStatus-ChildUid>를 제공합니다. 반환 시 나머지 구조체 멤버(공용 구조체)는 요청된 상태 받습니다.

[in] NonDestructiveOnly

디스플레이 미니포트 드라이버가 시각적 아티팩트 발생 방식으로 요청된 상태 확인할 수 있는지 여부를 지정하는 BOOLEAN 값입니다. 호출자가 이 매개 변수를 TRUE로 설정하면 표시 미니포트 드라이버가 아티팩트 발생을 허용하지 않습니다. 호출자가 이 매개 변수를 FALSE로 설정하면 표시 미니포트 드라이버가 아티팩트 발생을 허용합니다.

반환 값

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

설명

초기화 중에 디스플레이 포트 드라이버는 DxgkDdiQueryChildRelations 를 호출하여 MiniportDeviceContext가 나타내는 디스플레이 어댑터의 자식 디바이스 목록을 가져옵니다. 그런 다음 HPD 인식 값이 HpdAwarenessPolled 또는 HpdAwarenessInterruptible인 각 자식에 대해 디스플레이 포트 드라이버는 DxgkDdiQueryChildStatus 를 호출하여 자식에 현재 연결된 하드웨어(예: 모니터)가 있는지 확인합니다.

DxgkDdiQueryChildStatus 는 다음 작업을 수행해야 합니다.

ChildStatus->Type이 StatusConnection과 같으면 ChildStatus->HotPlug.Connected에서 부울 값을 반환합니다. ChildStatus->ChildUid로 식별된 자식 디바이스에 외부 하드웨어가 연결되어 있으면 TRUE 를 반환합니다. 그렇지 않으면 FALSE를 반환 합니다.
ChildStatus->형식이 StatusRotation과 같으면 ChildStatus->Rotation.Angle에서 ChildStatus->ChildUid로 식별된 자식 디바이스에 연결된 디스플레이의 회전 각도를 반환합니다.

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