DXGKARGCB_QUERYFEATUREINTERFACE struttura (d3dkmddi.h)

Articolo
05/23/2024

DXGKARGCB_QUERYFEATUREINTERFACE è il parametro della funzione di callback DXGKCB_QUERYFEATUREINTERFACE .

Sintassi

typedef struct _DXGKARGCB_QUERYFEATUREINTERFACE {
  DXGK_FEATURE_ID      FeatureId;
  DXGK_FEATURE_VERSION Version;
  UINT16               InterfaceSize;
  void                 *Interface;
} DXGKARGCB_QUERYFEATUREINTERFACE;

Members

FeatureId

[in] Valore di enumerazione DXGK_FEATURE_ID che specifica l'ID della funzionalità la cui interfaccia viene eseguita una query.

Version

[in] Versione della funzionalità di cui viene eseguita una query sull'interfaccia. Vedere la sezione Osservazioni.

InterfaceSize

[in/out] Dimensioni del buffer dell'interfaccia a cui l'interfaccia punta, in byte. In caso di esito positivo, questo valore deve essere impostato sulle dimensioni dell'interfaccia restituita. Se il valore di output è minore delle dimensioni di input dell'interfaccia richiesta, il chiamante deve restituire un errore, ad esempio STATUS_BUFFER_TOO_SMALL.

Interface

[in/out] Puntatore al buffer dell'interfaccia da inserire. Questo buffer è garantito essere esattamente byte InterfaceSize in lunghezza.

Commenti

Le interfacce delle funzionalità non devono essere compatibili con le versioni precedenti della stessa interfaccia. Ad esempio, l'interfaccia per la versione 1 e la versione 2 di una funzionalità possono essere radicalmente diverse, ovvero l'interfaccia v2 non deve essere un'estensione dell'interfaccia v1. Questo è utile per la visualizzazione delle funzionalità quando la progettazione di una funzionalità viene iterazione nel tempo, senza la necessità di supportare definitivamente un DDI per sempre.

Per altre informazioni, vedere Esecuzione di query sul supporto e l'abilitazione delle funzionalità WDDM.