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

Vedi anche

DXGK_NODEMETADATA

DxgkDdiStartDevice