DXGKDDI_GETNODEMETADATA fonction de rappel (d3dkmddi.h)

  • Article

À partir d’un handle d’adaptateur fourni, DXGKDDI_GETNODEMETADATA retourne les métadonnées d’un moteur sur un nœud GPU spécifié.

Syntaxe

DXGKDDI_GETNODEMETADATA DxgkddiGetnodemetadata;

NTSTATUS DxgkddiGetnodemetadata(
  [in] IN_CONST_HANDLE hAdapter,
       UINT NodeOrdinalAndAdapterIndex,
       OUT_PDXGKARG_GETNODEMETADATA pGetNodeMetadata
)
{...}

Paramètres

[in] hAdapter

[in] Handle qui identifie une carte d’affichage. Dxgkrnl a précédemment fourni cette poignée au pilote miniport d’affichage (KMD) dans le paramètre DxgkInterface de la fonction DxgkDdiStartDevice .

NodeOrdinalAndAdapterIndex

[in] Index d’un nœud pour lequel les informations du moteur sont obtenues. Ce nœud se trouve dans l’adaptateur physique défini par le paramètre hAdapter .

pGetNodeMetadata

[out] Pointeur vers une structure DXGKARG_GETNODEMETADATA dans laquelle KMD retourne les métadonnées du moteur spécifié par NodeOrdinal.

Notez que la structure DXGKARG_GETNODEMETADATA est déclarée en tant que structure DXGK_NODEMETADATA .

Valeur retournée

Renvoie l'une des valeurs suivantes :

Code de retour Description
STATUS_SUCCESS DxgkDdiGetNodeMetadata a correctement récupéré les informations du moteur.
STATUS_INVALID_PARAMETER Le paramètre hAdapter ou pGetNodeMetadata n’est pas valide, ou NodeOrdinal est supérieur ou égal au nombre de nœuds sur l’adaptateur.

Si les paramètres hAdapter et pGetNodeMetadata sont valides et que NodeOrdinal a une valeur comprise entre 0 et (nombre de nœuds - 1), tous les appels à cette fonction doivent réussir.

Remarques

KMD définit les bits pour chaque fonctionnalité prise en charge par le nœud GPU spécifié. Le système d’exploitation permet à UMD d’utiliser uniquement les fonctionnalités de métadonnées prises en charge par les rapports KMD.

Les pilotes d’affichage miniport (KMD) WDDM 1.3 et versions ultérieures doivent implémenter DXGKDDI_GETNODEMETADATA.

Pour plus d’informations sur l’implémentation de cette fonction, consultez Énumération des fonctionnalités du moteur GPU.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8.1 (WDDM 1.3)
Serveur minimal pris en charge Windows Server 2012 R2
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dkmddi.h (inclure D3dkmddi.h)
IRQL PASSIVE_LEVEL

Voir aussi

DXGK_NODEMETADATA

DxgkDdiStartDevice