DXGKDDI_GETNODEMETADATA funzione di callback (d3dkmddi.h)
Da un handle di adattatore fornito, DXGKDDI_GETNODEMETADATA restituisce i metadati di un motore in un nodo GPU specificato.
Sintassi
DXGKDDI_GETNODEMETADATA DxgkddiGetnodemetadata;
NTSTATUS DxgkddiGetnodemetadata(
[in] IN_CONST_HANDLE hAdapter,
UINT NodeOrdinalAndAdapterIndex,
OUT_PDXGKARG_GETNODEMETADATA pGetNodeMetadata
)
{...}
Parametri
[in] hAdapter
[in] Handle che identifica una scheda di visualizzazione. Dxgkrnl precedentemente fornito questo handle al driver miniport (KMD) visualizzato nella DxgkInterface parametro della funzione DxgkDdiStartDevice.
NodeOrdinalAndAdapterIndex
[in] Indice di un nodo per il quale vengono ottenute le informazioni del motore. Questo nodo si trova all'interno dell'adattatore fisico definito dal parametro hAdapter.
pGetNodeMetadata
[out] Puntatore a una struttura DXGKARG_GETNODEMETADATA in cui kmD restituisce i metadati del motore specificato da NodeOrdinal.
Si noti che la struttura DXGKARG_GETNODEMETADATA viene dichiarata come struttura DXGK_NODEMETADATA.
Valore restituito
Restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | DxgkDdiGetNodeMetadata recuperato correttamente le informazioni del motore. |
| STATUS_INVALID_PARAMETER | Il parametro hAdapter o pGetNodeMetadata non è valido oppure nodeOrdinal è maggiore o uguale al numero di nodi nella scheda. |
Se i parametri hAdapter e pGetNodeMetadata sono validi e NodeOrdinal ha un valore compreso nell'intervallo da 0 a (numero di nodi - 1), tutte le chiamate a questa funzione devono avere esito positivo.
Osservazioni
KmD imposta i bit per ogni funzionalità supportata dal nodo GPU specificato. Il sistema operativo consente a UMD di usare solo le funzionalità di metadati per cui il KmD segnala il supporto.
WDDM 1.3 e versioni successive devono implementare i driver miniport (KMD) DXGKDDI_GETNODEMETADATA.
Per altre informazioni su come implementare questa funzione, vedere Enumerazione delle funzionalità del motore GPU.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 8.1 (WDDM 1.3) |
| server minimo supportato | Windows Server 2012 R2 |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |