DXGKDDI_GET_CHILD_CONTAINER_ID 콜백 함수(dispmprt.h)

지정된 대상에 대한 컨테이너 ID를 쿼리합니다. WDDM(Windows Display Driver Model) 1.2 이상 디스플레이 미니포트 드라이버에 의해 구현됩니다.

구문

DXGKDDI_GET_CHILD_CONTAINER_ID DxgkddiGetChildContainerId;

NTSTATUS DxgkddiGetChildContainerId(
  [in]      PVOID MiniportDeviceContext,
  [in]      ULONG ChildUid,
  [in, out] PDXGK_CHILD_CONTAINER_ID ContainerId
)
{...}

매개 변수

[in] MiniportDeviceContext

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

[in] ChildUid

자식 디바이스를 고유하게 식별하는 ULONG 값입니다. 디스플레이 미니포트 드라이버는 이전에 DxgkDdiQueryChildRelations 함수가 호출되었을 때 이 식별자를 제공했습니다.

[in, out] ContainerId

DXGK_CHILD_CONTAINER_ID 구조체에 대한 포인터입니다. 자세한 내용은 주의 섹션을 참조하세요.

반환 값

다음 오류 코드 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	드라이버가 ContainerId 매개 변수가 가리키는 구조를 디스플레이 하드웨어에서 가져온 컨테이너 ID 정보로 업데이트했습니다.
STATUS_MONITOR_NODESCRIPTOR	드라이버가 ContainerId가 가리키는 구조에 제공된 기본 컨테이너 ID 정보를 수락했습니다. 참고: 드라이버가 이 상태 코드를 반환하는 경우 구조를 수정하면 안 됩니다.

그렇지 않으면 함수는 Ntstatus.h에 정의된 상태 코드 중 하나를 반환합니다.

설명

운영 체제는 디스플레이 미니포트 드라이버의 DxgkDdiQueryChildRelations 함수를 호출하여 디스플레이 어댑터의 자식 디바이스를 열거합니다. 그런 다음 운영 체제는 각 자식 디바이스에 대해 디스플레이 미니포트 드라이버의 DxgkDdiQueryDeviceDescriptor 함수를 호출하여 디바이스에 대한 EDID(확장 디스플레이 정보 데이터)를 가져옵니다. 이 절차에 대한 자세한 내용은 디스플레이 어댑터의 자식 디바이스 열거를 참조하세요.

디바이스의 EDID 데이터에 따라 운영 체제는 자식 디바이스에 대한 기본 컨테이너 ID를 생성합니다. 그런 다음 운영 체제는 디스플레이 미니포트 드라이버의 DxgkDdiGetChildContainerId 함수를 호출하고 ContainerId 매개 변수를 통해 DXGK_CHILD_CONTAINER_ID 구조에 대한 포인터를 전달합니다. 이 구조체의 ContainerId 멤버에는 자식 표시 디바이스에 대한 기본 컨테이너 ID가 포함됩니다.

디스플레이 미니포트 드라이버는 DxgkDdiGetChildContainerId 호출에서 반환되기 전에 기본 컨테이너 ID를 수락하거나 ContainerId 멤버를 디바이스의 고유 식별자로 설정할 수 있습니다.

컨테이너 ID에 대한 자세한 내용은 컨테이너 ID를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	데스크톱
머리글	dispmprt.h
IRQL	PASSIVE_LEVEL

추가 정보

DXGK_CHILD_CONTAINER_ID

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

DxgkDdiQueryDeviceDescriptor