Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
À 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 un adaptateur d’affichage. Dxgkrnl précédemment fourni ce handle au pilote de 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 de retour
Retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | DxgkDdiGetNodeMetadata 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 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 de 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.
WDDM 1.3 et les pilotes de miniport (KMD) 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8.1 (WDDM 1.3) |
| serveur minimum pris en charge | Windows Server 2012 R2 |
| plateforme cible | Bureau |
| d’en-tête | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |