D3DDDI_QUERYREGISTRY_INFO-Struktur (d3dukmdt.h)

Artikel
02/23/2024

Die D3DDDI_QUERYREGISTRY_INFO-Struktur gibt an, wie D3DKMT_QUERYADAPTERINFO::p DriverPrivateData neu interpretiert werden soll, wenn D3DKMT_QUERYADAPTERINFO::TypeKMTQAITYPE_QUERYREGISTRY.

Syntax

typedef struct _D3DDDI_QUERYREGISTRY_INFO {
  D3DDDI_QUERYREGISTRY_TYPE   QueryType;
  D3DDDI_QUERYREGISTRY_FLAGS  QueryFlags;
  WCHAR                       ValueName[MAX_PATH];
  ULONG                       ValueType;
  ULONG                       PhysicalAdapterIndex;
  ULONG                       OutputValueSize;
  D3DDDI_QUERYREGISTRY_STATUS Status;
  union {
    DWORD                 OutputDword;
    D3DKMT_ALIGN64 UINT64 OutputQword;
    WCHAR                 OutputString[1];
    BYTE                  OutputBinary[1];
  };
} D3DDDI_QUERYREGISTRY_INFO;

Member

QueryType

[in] Ein D3DDDI_QUERYREGISTRY_TYPE Wert, der angibt, welche Daten abgerufen werden sollen.

QueryType ist das wichtigste Feld. Es gibt an, ob die Registrierungs- oder Dateipfade abgerufen werden, sowie welche bestimmte Registrierungsstruktur und welcher Dateipfad.

Registrierungsschlüsselenumen:

D3DDDI_QUERYREGISTRY_SERVICEKEY
D3DDDI_QUERYREGISTRY_ADAPTERKEY

Dateipfad-Enumerationen:

D3DDDI_QUERYREGISTRY_DRIVERSTOREPATH
D3DDDI_QUERYREGISTRY_DRIVERIMAGEPATH

QueryFlags

[in] Eine D3DDDI_QUERYREGISTRY_FLAGS-Struktur mit Flags, die steuern, wie Zeichenfolgen abgerufen werden. QueryFlags kann zusätzliche Vorgänge ausführen, z. B. das Übersetzen abgerufener Zeichenfolgen mit Dateipfaden in die Gastumgebung.

ValueName[MAX_PATH]

[in] Beim Abrufen von Registrierungsinformationen muss ValueName den abzurufenden Registrierungswertnamen angeben. Beim Abrufen von Dateipfadinformationen wird ValueName ignoriert.

ValueType

[in] Beim Abrufen von Registrierungsinformationen muss ValueType den erwarteten Registrierungswerttyp angeben, der dem Namen des Registrierungswerts entspricht. Beim Abrufen von Dateipfadinformationen muss ValueType 0 sein, um erfolgreich zu sein. Weitere Informationen finden Sie unter Registrierungswerttypen .

PhysicalAdapterIndex

[in] Der index des physischen Adapters in einer LDA-Kette.

OutputValueSize

[out] Die Größe der Ausgabedaten wird in dieses Feld abgerufen, auch wenn nicht genügend Platz zum Abrufen dieser Daten vorhanden ist. Dieses Feld ist besonders nützlich, wenn Daten mit variabler Größe abgerufen werden.

Status

[out] Ein D3DDDI_QUERYREGISTRY_STATUS Wert, der die status der Abfrage angibt.

Die status der Abfrage wird separat zurückgegeben, um anzugeben, dass unterschiedliche Datenmengen abgerufen wurden. Die folgenden drei Rückgabezustände sind am wichtigsten, um zu verstehen:

Wenn QueryAdapterInfo STATUS_SUCCESS zurückgibt und StatusD3DDDI_QUERYREGISTRY_STATUS_SUCCESS ist, sind alle Felder, die mit Ausgabe beginnen, gültig.
Wenn QueryAdapterInfo STATUS_SUCCESS zurückgibt und StatusD3DDDI_QUERYREGISTRY_STATUS_BUFFER_OVERFLOW ist, ist nur OutputValueSize gültig.
Wenn QueryAdapterInfo nicht STATUS_SUCCESS zurückgibt, bleiben alle Felder unverändert, außer Status kann in D3DDDI_QUERYREGISTRY_STATUS_FAIL geändert werden.

OutputDword

[out] Ein benutzerfreundliches Feld zum Neuinterpretieren der erfolgreich abgerufenen Daten. Es ist besonders nützlich, wenn ein RegistrierungsdWORD gelesen wird.

OutputQword

[out] Ein benutzerfreundliches Feld zum Neuinterpretieren der erfolgreich abgerufenen Daten. Es ist besonders nützlich, wenn ein Registrierungs-QWORD gelesen wird.

OutputString[1]

OutputBinary[1]

Hinweise

D3DDDI_QUERYREGISTRY_INFO wird verwendet, um die Registrierung nach Informationen zu lesen, die häufig während der Treiberinstallation zwischengespeichert werden.

Anstatt unformatierte Betriebssystemmethoden zu verwenden, müssen Benutzermodustreiber und andere Komponenten diese Technik in allen Betriebssystemversionen verwenden, in denen sie unterstützt wird. Dadurch kann das Betriebssystem die Kompatibilität des Benutzermodus mit Abhängigkeitsänderungen und Szenarien wie virtualisierten Umgebungen maximieren.