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 in precedenza ha fornito questo handle al driver miniport di visualizzazione (KMD) nel parametro DxgkInterface della funzione DxgkDdiStartDevice .
NodeOrdinalAndAdapterIndex
[in] Indice di un nodo per il quale vengono ottenute le informazioni sul 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 ha 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 nell'adapter. |
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.
Commenti
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 supportate dal Servizio di gestione delle chiavi.
WdDM 1.3 e versioni successive visualizzano i driver miniport (KMD) devono implementare DXGKDDI_GETNODEMETADATA.
Per altre informazioni su come implementare questa funzione, vedere Enumerazione delle funzionalità del motore GPU.
Requisiti
| 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 |