DXGKDDI_GETNODEMETADATA fonction de rappel (d3dkmddi.h)
À 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 |