struttura QUERY_INTERFACE (video.h)

Articolo
01/16/2025

La struttura QUERY_INTERFACE descrive l'interfaccia richiesta.

Sintassi

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

Membri

InterfaceType

Puntatore a un GUID che identifica l'interfaccia richiesta. Se il driver miniport in modalità kernel (KMD) (o driver miniport video legacy) non supporta il InterfaceType specificato, deve non riuscire la chiamata e restituire immediatamente.

L'elemento padre genera questo GUID con uuidgen.exe. Per informazioni dettagliate, vedere Definizione ed esportazione di nuovi GUID.

Size

Specifica le dimensioni in byte della struttura INTERFACE a cui punta Interface. Il driver non deve restituire una struttura INTERFACE più grande di dimensioni byte.

Version

Specifica la versione dell'interfaccia richiesta.

Se un elemento padre supporta più versioni di un'interfaccia, il driver deve restituire la versione specificata o, se possibile, la versione supportata più vicina senza superare la versione richiesta. Il chiamante è responsabile dell'analisi dell' versione restituita e di determinare le operazioni da eseguire in base a tale valore.

Interface

Puntatore a una struttura INTERFACE in cui il driver restituisce le informazioni sull'interfaccia richieste. Il chiamante è responsabile dell'allocazione di questa struttura prima di chiamare DxgkddiQueryInterface (o HwVidQueryInterface).

InterfaceSpecificData

Specifica informazioni aggiuntive sull'interfaccia richiesta. In genere, questo membro è NULL e i membri InterfaceType e Version sono sufficienti per consentire all'elemento padre di identificare l'interfaccia richiesta.

DeviceUid

Intero positivo che identifica il dispositivo per il quale viene eseguita una query sull'interfaccia. Se DeviceUid è uguale a DISPLAY_ADAPTER_HW_ID (definito in Video.h), il dispositivo è la scheda di visualizzazione stessa. In caso contrario, DeviceUid è l'identificatore di un dispositivo figlio della scheda di visualizzazione. Gli identificatori di dispositivo figlio sono stati precedentemente assegnati dalla funzione dxgkDdiQueryChildRelations . Disponibile a partire da Windows 8.1 (WDDM 1.3).

Osservazioni

Il parametro QueryInterface del DxgkddiQueryInterface callback (o driver miniport video legacy funzione HwVidQueryInterface) è un puntatore a una struttura QUERY_INTERFACE.

Fabbisogno

Requisito	Valore
intestazione	video.h (includere Video.h)

Vedere anche

DxgkddiQueryInterface

HwVidQueryInterface

Condividi tramite