DXGKDDI_QUERYADAPTERINFO funzione di callback (d3dkmddi.h)

La funzione DxgkDdiQueryAdapterInfo recupera le informazioni di configurazione dalla scheda grafica.

Sintassi

DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;

NTSTATUS DxgkddiQueryadapterinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}

Parametri

[in] hAdapter

Handle a un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport visualizzato in precedenza ha fornito questo handle al sottosistema kernel della grafica Microsoft DirectX nel parametro di output MiniportDeviceContext della funzione DxgkDdiAddDevice .

[in] pQueryAdapterInfo

Puntatore a una struttura DXGKARG_QUERYADAPTERINFO che il driver miniport visualizzato riempie con le informazioni di configurazione per la scheda grafica.

Valore restituito

DxgkDdiQueryAdapterInfo restituisce uno dei valori seguenti:

Codice restituito Descrizione
STATUS_SUCCESS DxgkDdiQueryAdapterInfo ha recuperato correttamente le informazioni di configurazione.
STATUS_INVALID_PARAMETER I parametri passati a DxgkDdiQueryAdapterInfo contengono errori che impediscono il completamento.
STATUS_NO_MEMORY DxgkDdiQueryAdapterInfo non è stato in grado di allocare memoria necessaria per il completamento.
STATUS_GRAPHICS_DRIVER_MISMATCH Il driver miniport visualizzato non è compatibile con il driver di visualizzazione in modalità utente che ha avviato la chiamata a DxgkDdiQueryAdapterInfo, ovvero i dati privati forniti per una query al driver miniport visualizzato.

Commenti

Quando il driver di visualizzazione in modalità utente chiama la funzione pfnQueryAdapterInfoCb , viene avviata una chiamata alla funzione DxgkDdiQueryAdapterInfo . DxgkDdiQueryAdapterInfo riceve il valore DXGKQAITYPE_UMDRIVERPRIVATE nel membro Typedella struttura DXGKARG_QUERYADAPTERINFO a cui punta il parametro pQueryAdapterInfo . Questa funzione riceve anche un buffer proprietario nel membro pOutputData che riempie le informazioni di configurazione necessarie per il driver di visualizzazione in modalità utente per identificare l'adapter.

Se il sottosistema del kernel grafico DirectX (che fa parte diDxgkrnl.sys) specifica il valore DXGKQAITYPE_DRIVERCAPS nel membro Type di DXGKARG_QUERYADAPTERINFO quando il sottosistema chiama DxgkDdiQueryAdapterInfo, il driver miniport visualizzato deve popolare la struttura DXGK_DRIVERCAPS fornita con informazioni che il sottosistema può usare.

Se il sottosistema del kernel grafico DirectX fornisce il valore DXGKQAITYPE_QUERYSEGMENT nel membro Type di DXGKARG_QUERYADAPTERINFO, il driver miniport visualizzato deve fornire informazioni sui segmenti di memoria supportati. Per altre informazioni sui segmenti di memoria, vedere Inizializzazione dei segmenti di memoria.

DxgkDdiQueryAdapterInfo deve essere reso paginabile.

Nota

Tutti i driver che supportano WDDM 2.6 devono implementare il callback DxgkDdiQueryAdapterInfo.

Requisiti

   
Client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione Desktop
Intestazione d3dkmddi.h
IRQL PASSIVE_LEVEL

Vedi anche

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb