QUERY_INTERFACE 구조체(video.h)

QUERY_INTERFACE 구조는 요청되는 인터페이스를 설명합니다.

통사론

typedef struct _QUERY_INTERFACE {
  const GUID *InterfaceType;
  USHORT     Size;
  USHORT     Version;
  PINTERFACE Interface;
  PVOID      InterfaceSpecificData;
  ULONG      DeviceUid;
} QUERY_INTERFACE, *PQUERY_INTERFACE;

회원

InterfaceType

요청되는 인터페이스를 식별하는 GUID에 대한 포인터입니다. 커널 모드 디스플레이 미니포트 드라이버(KMD) 또는 레거시 비디오 미니포트 드라이버)가 지정된 InterfaceType지원하지 않는 경우 호출에 실패하고 즉시 반환됩니다.

부모는 uuidgen.exe사용하여 이 GUID를 생성합니다. 자세한 내용은 새 GUID 정의 및 내보내기 참조하세요.

Size

Interface가 가리키는 INTERFACE 구조체의 크기(바이트)를 지정합니다. 드라이버는 Size 바이트보다 큰 INTERFACE 구조를 반환해서는 안됩니다.

Version

요청되는 인터페이스의 버전을 지정합니다.

부모가 둘 이상의 인터페이스 버전을 지원하는 경우 해당 드라이버는 지정된 버전을 반환하거나 가능한 경우 요청된 버전을 초과하지 않고 지원되는 가장 가까운 버전을 반환해야 합니다. 호출자는 반환된 버전 검사하고 해당 값에 따라 수행할 작업을 결정합니다.

Interface

드라이버가 요청된 인터페이스 정보를 반환하는 INTERFACE 구조체에 대한 포인터입니다. 호출자는 DxgkddiQueryInterface(또는 HwVidQueryInterface)를 호출하기 전에 이 구조를 할당해야 합니다.

InterfaceSpecificData

요청되는 인터페이스에 대한 추가 정보를 지정합니다. 일반적으로 이 멤버는 NULL이며 InterfaceType 및 버전 멤버는 부모가 요청되는 인터페이스를 식별하기에 충분합니다.

DeviceUid

인터페이스가 쿼리되는 디바이스를 식별하는 양의 정수입니다. deviceUid DISPLAY_ADAPTER_HW_ID(Video.h정의됨)이 같으면 디바이스는 디스플레이 어댑터 자체입니다. 그렇지 않으면 DeviceUid 디스플레이 어댑터의 자식 디바이스 식별자입니다. 자식 디바이스 식별자는 이전에 DxgkDdiQueryChildRelations 함수에 의해 할당되었습니다. Windows 8.1(WDDM 1.3)부터 사용할 수 있습니다.

발언

KMD의 DxgkddiQueryInterface 콜백(또는 HwVidQueryInterface 함수를레거시 비디오 미니포트 드라이버)의 QueryInterface 매개 변수는 QUERY_INTERFACE 구조에 대한 포인터입니다.

요구 사항

참고 항목

DxgkddiQueryInterface

HwVidQueryInterface