struttura D3DDDI_QUERYREGISTRY_INFO (d3dukmdt.h)

Articolo
02/26/2024

La struttura D3DDDI_QUERYREGISTRY_INFO indica come D3DKMT_QUERYADAPTERINFO::p DriverPrivateData deve essere reinterpretato quando D3DKMT_QUERYADAPTERINFO::Type viene KMTQAITYPE_QUERYREGISTRY.

Sintassi

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;

Members

QueryType

[in] Valore D3DDDI_QUERYREGISTRY_TYPE che indica quali dati recuperare.

QueryType è il campo più significativo. Indica se vengono recuperati i percorsi del Registro di sistema o dei file, nonché quale percorso di file e hive del Registro di sistema specifico.

Enumerazioni chiave del Registro di sistema:

D3DDDI_QUERYREGISTRY_SERVICEKEY
D3DDDI_QUERYREGISTRY_ADAPTERKEY

Enumerazioni percorso file:

D3DDDI_QUERYREGISTRY_DRIVERSTOREPATH
D3DDDI_QUERYREGISTRY_DRIVERIMAGEPATH

QueryFlags

[in] Struttura D3DDDI_QUERYREGISTRY_FLAGS con flag che controllano la modalità di recupero delle stringhe. QueryFlags può eseguire operazioni aggiuntive, ad esempio tradurre stringhe recuperate contenenti percorsi di file nell'ambiente guest.

ValueName[MAX_PATH]

[in] Quando si recuperano le informazioni del Registro di sistema, ValueName deve specificare il nome del valore del Registro di sistema da recuperare. Quando si recuperano informazioni sul percorso del file, ValueName viene ignorato.

ValueType

[in] Quando si recuperano le informazioni del Registro di sistema, ValueType deve specificare il tipo di valore del Registro di sistema previsto corrispondente al nome del valore del Registro di sistema. Quando si recuperano informazioni sul percorso del file, ValueType deve essere 0 per avere esito positivo. Per altri dettagli, vedere Tipi di valore del Registro di sistema .

PhysicalAdapterIndex

[in] Indice dell'adattatore fisico in una catena LDA.

OutputValueSize

[out] Le dimensioni dei dati di output vengono recuperate in questo campo, anche quando non c'era spazio sufficiente per recuperare tali dati. Questo campo è più utile quando vengono recuperati dati di dimensioni variabili.

Status

[out] Valore D3DDDI_QUERYREGISTRY_STATUS che indica lo stato della query.

Lo stato della query viene restituito separatamente per indicare che sono state recuperate quantità variabili di dati. I tre stati restituiti seguenti sono più importanti da comprendere:

Quando QueryAdapterInfo restituisce STATUS_SUCCESS e Status è D3DDDI_QUERYREGISTRY_STATUS_SUCCESS, tutti i campi che iniziano con Output sono validi.
Quando QueryAdapterInfo restituisce STATUS_SUCCESS e Status è D3DDDI_QUERYREGISTRY_STATUS_BUFFER_OVERFLOW, solo OutputValueSize è valido.
Quando QueryAdapterInfo non restituisce STATUS_SUCCESS, tutti i campi vengono lasciati invariati, ad eccezione di Status può essere modificato in D3DDDI_QUERYREGISTRY_STATUS_FAIL.

OutputDword

[out] Un campo pratico per reinterpretare i dati recuperati correttamente. È più utile quando viene letto un DWORD del Registro di sistema.

OutputQword

[out] Un campo pratico per reinterpretare i dati recuperati correttamente. È più utile quando viene letto un QWORD del Registro di sistema.

OutputString[1]

OutputBinary[1]

Commenti

D3DDDI_QUERYREGISTRY_INFO viene usato per leggere il Registro di sistema per informazioni comunemente memorizzate nella cache durante l'installazione del driver.

Invece di usare metodi del sistema operativo non elaborati, i driver in modalità utente e altri componenti devono usare in modo comune questa tecnica nelle versioni del sistema operativo in cui è supportata. Ciò consente al sistema operativo di ottimizzare la compatibilità della modalità utente con modifiche delle dipendenze e scenari come ambienti virtualizzati.