struttura DXGKARG_QUERYFEATUREINTERFACE (d3dkmddi.h)

Articolo
05/23/2024

DXGKARG_QUERYFEATUREINTERFACE è il parametro della funzione DxgkDdiQueryFeatureInterface .

Sintassi

typedef struct _DXGKARG_QUERYFEATUREINTERFACE {
  DXGK_FEATURE_ID      FeatureId;
  DXGK_FEATURE_VERSION Version;
  UINT16               InterfaceSize;
  void                 *Interface;
} DXGKARG_QUERYFEATUREINTERFACE;

Members

FeatureId

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

Version

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

InterfaceSize

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

Interface

[in/out] Puntatore al buffer di interfaccia da compilare. Questo buffer è garantito che sia esattamente in byte InterfaceSize .

Commenti

Le interfacce di 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à può essere radicalmente diversa, ovvero l'interfaccia v2 non deve essere un'estensione dell'interfaccia v1. Ciò è utile per la visualizzazione delle funzionalità quando la progettazione di una funzionalità viene iterata nel tempo, senza la necessità di supportare definitivamente un DDI per sempre.

Anche se l'interfaccia di una funzionalità per una determinata versione può essere definita per sempre in un punto qualsiasi della documentazione, il sistema operativo e il driver possono impostare una versione inferiore (minima) supportata di una funzionalità per ridurre la necessità di supportare le interfacce obsolete e deprecate.

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