DXGKDDI_QUERYADAPTERINFO funzione di callback (d3dkmddi.h)
Dxgkrnl chiama la funzione di DxgkDdiQueryAdapterInfo del driver miniport per recuperare 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 di un blocco di contesto associato a una scheda di visualizzazione. Il KMD ha fornito in precedenza questo handle per dxgkrnl nella MiniportDeviceContext parametro di output della funzione DxgkDdiAddDevice.
[in] pQueryAdapterInfo
Puntatore a una struttura DXGKARG_QUERYADAPTERINFO riempita dal kmD con le informazioni di configurazione per la scheda grafica.
Valore restituito
DxgkDdiQueryAdapterInfo restituisce STATUS_SUCCESS quando recupera correttamente le informazioni di configurazione. In caso contrario, restituisce un codice NTSTATUS, ad esempio uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Uno o più parametri passati contengono errori che hanno impedito il completamento. |
| STATUS_NO_MEMORY | DxgkDdiQueryAdapterInfo non è riuscito ad allocare memoria necessaria per il completamento. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | Il KMD non è compatibile con il driver di visualizzazione in modalità utente (UMD) che ha avviato la chiamata a DxgkDdiQueryAdapterInfo (ovvero i dati privati forniti per una query al KMD). |
Osservazioni
Quando il UMD chiama il runtime Direct3D pfnQueryAdapterInfoCb callback, viene avviata una chiamata al DxgkDdiQueryAdapterInfo funzione.
Se Dxgkrnl specifica DXGKQAITYPE_UMDRIVERPRIVATE in DXGKARG_QUERYADAPTERINFO::Type, pOutputData punta a una struttura proprietaria che kmD riempie con le informazioni di configurazione necessarie per identificare l'adattatore.
Se Dxgkrnl specifica DXGKQAITYPE_DRIVERCAPS in DXGKARG_QUERYADAPTERINFO::Type, il kmD deve popolare la struttura DXGK_DRIVERCAPS fornita con informazioni che il sottosistema può usare.
Se dxgkrnl specifica DXGKQAITYPE_QUERYSEGMENT in DXGKARG_QUERYADAPTERINFO::Type, il kmD deve fornire informazioni sui segmenti di memoria supportati. Per altre informazioni sui segmenti di memoria, vedere inizializzazione dell'uso dei segmenti di memoria.
DxgkDdiQueryAdapterInfo deve essere reso pageable.
Tutti i driver che supportano WDDM 2.6 e versioni successive devono implementare il callback DxgkDdiQueryAdapter Info.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista (WDDM 1.0) |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |