Freigeben über


DXGKARG_QUERYFEATUREINTERFACE Struktur (d3dkmddi.h)

DXGKARG_QUERYFEATUREINTERFACE ist der Parameter für die funktion DxgkDdiQueryFeatureInterface.

Syntax

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

Angehörige

FeatureId

[in] Ein DXGK_FEATURE_ID Enumerationswert, der die ID des Features angibt, dessen Schnittstelle abgefragt wird.

Version

[in] Die Version des Features, dessen Schnittstelle abgefragt wird. Siehe Anmerkungen.

InterfaceSize

[in/out] Die Größe des Schnittstellenpuffers, auf den Interface in Byte verweist. Bei Erfolg muss dieser Wert auf die Größe der zurückgegebenen Schnittstelle festgelegt werden. Wenn der Ausgabewert kleiner als die Eingabegröße der angeforderten Schnittstelle ist, sollte der Aufrufer einen Fehler zurückgeben, z. B. STATUS_BUFFER_TOO_SMALL.

Interface

[in/out] Ein Zeiger auf den Schnittstellenpuffer, der ausgefüllt werden soll. Dieser Puffer ist garantiert genau InterfaceSize Bytes länge.

Bemerkungen

Featureschnittstellen müssen nicht abwärtskompatibel mit älteren Versionen derselben Schnittstelle sein. Die Schnittstelle für Version 1 und Version 2 eines Features kann beispielsweise radikal anders sein (d. h. die v2-Schnittstelle muss keine Erweiterung der v1-Schnittstelle sein). Dies ist nützlich, wenn das Design eines Features im Laufe der Zeit durchlaufen wird, ohne dass ein DDI dauerhaft unterstützt werden muss.

Während die Schnittstelle eines Features für eine bestimmte Version möglicherweise irgendwo in der Dokumentation für immer definiert wird, kann das Betriebssystem und der Treiber eine untere (minimale) unterstützte Version eines Features festlegen, um die Notwendigkeit zu verringern, alte, veraltete Schnittstellen zu unterstützen.

Weitere Informationen finden Sie unter Abfragen der WDDM-Featureunterstützung und -aktivierung.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 11, Version 24H2 (WDDM 3.2)
Header- d3dkmddi.h

Siehe auch

DXGK_FEATURE_ID

DXGKDDI_FEATURE_INTERFACE

DxgkDdiQueryFeatureInterface