Partager via


DXGKARG_QUERYFEATUREINTERFACE structure (d3dkmddi.h)

DXGKARG_QUERYFEATUREINTERFACE est le paramètre de la fonction DxgkDdiQueryFeatureInterface .

Syntaxe

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

Membres

FeatureId

[in] Valeur d’énumération DXGK_FEATURE_ID qui spécifie l’ID de la fonctionnalité dont l’interface est interrogée.

Version

[in] Version de la fonctionnalité dont l’interface est interrogée. Consultez la section Notes.

InterfaceSize

[entrée/sortie] Taille de la mémoire tampon d’interface vers laquelle l’interface pointe, en octets. En cas de réussite, cette valeur doit être définie sur la taille de l’interface retournée. Si la valeur de sortie est inférieure à la taille d’entrée de l’interface demandée, l’appelant doit retourner une erreur, telle que STATUS_BUFFER_TOO_SMALL.

Interface

[entrée/sortie] Pointeur vers la mémoire tampon d’interface à remplir. Il est garanti que cette mémoire tampon est exactement d’une longueur d’InterfaceSize octets.

Remarques

Il n’est pas nécessaire que les interfaces de fonctionnalités soient rétrocompatibles avec les versions antérieures de la même interface. Par exemple, l’interface pour les versions 1 et 2 d’une fonctionnalité peut être radicalement différente (autrement dit, l’interface v2 n’a pas besoin d’être une extension de l’interface v1). Cela est utile pour la génération de fonctionnalités lorsque la conception d’une fonctionnalité est itérée au fil du temps, sans qu’il soit nécessaire de prendre en charge définitivement une DDI.

Alors que l’interface d’une fonctionnalité pour une version particulière peut être définie à jamais quelque part dans la documentation, le système d’exploitation et le pilote peuvent définir une limite inférieure (minimale) prise en charge version d’une fonctionnalité pour réduire la nécessité de prendre en charge les anciennes interfaces dépréciées.

Pour plus d’informations, consultez Interrogation de la prise en charge et de l’activation des fonctionnalités WDDM.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 11, version 24H2 (WDDM 3.2)
En-tête d3dkmddi.h

Voir aussi

DXGK_FEATURE_ID

DXGKDDI_FEATURE_INTERFACE

DxgkDdiQueryFeatureInterface