DXGKDDI_QUERYADAPTERINFO funzione di callback (d3dkmddi.h)
La funzione DxgkDdiQueryAdapterInfo del display 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 KMD ha fornito in precedenza questo handle a Dxgkrnl nel parametro di output MiniportDeviceContext della funzione DxgkDdiAddDevice .
[in] pQueryAdapterInfo
Puntatore a una struttura DXGKARG_QUERYADAPTERINFO che il kmD 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 .
Se DxgkDdiQueryAdapterInfo riceve il valore DXGKQAITYPE_UMDRIVERPRIVATE nel membro Type della strutturaDXGKARG_QUERYADAPTERINFO a cui punta il parametro pQueryAdapterInfo, pOutputData punta a una struttura proprietaria che kmD riempie con le informazioni di configurazione necessarie per il driver di visualizzazione in modalità utente per identificare l'adattatore.
Se Dxgkrnl specifica il valore DXGKQAITYPE_DRIVERCAPS nel membro Type di DXGKARG_QUERYADAPTERINFO quando il sottosistema chiama DxgkDdiQueryAdapterInfo, il driver miniport visualizzato deve popolare la struttura di 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.
Tutti i driver che supportano WDDM 2.6 e versioni successive devono implementare il callback DxgkDdiQueryAdapterInfo .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Piattaforma di destinazione | Desktop |
| Intestazione | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |