NdisGetHypervisorInfo, fonction (ndis.h)
À compter de Windows 10 version 1703, NdisGetHypervisorInfo est déconseillé et ne doit pas être utilisé. Les pilotes sont encouragés à s’en éloigner, car ils peuvent ne pas être disponibles dans les futures versions du système d’exploitation.
Les pilotes doivent plutôt suivre les instructions d’un hyperviseur pour interroger la présence et les fonctionnalités d’hyperviseur. Par exemple, les instructions d’Hyper-V sont documentées dans la Top-Level spécification fonctionnelle.
La fonction NdisGetHypervisorInfo retourne des informations sur l’hyperviseur présent sur le système.
Syntaxe
NDIS_STATUS NdisGetHypervisorInfo(
[in, out] PNDIS_HYPERVISOR_INFO HypervisorInfo
);
Paramètres
[in, out] HypervisorInfo
Pointeur vers une structure NDIS_HYPERVISOR_INFO allouée par l’appelant qui contient des informations sur l’hyperviseur présent sur le système.
Valeur de retour
NdisGetHypervisorInfo pouvez retourner l’une des valeurs d’état suivantes :
| Retourner le code | Description |
|---|---|
|
L’opération s’est terminée avec succès. |
|
La taille de la mémoire tampon du paramètre d’entrée était trop petite. |
Remarques
Les pilotes miniport NDIS appellent la fonction NdisGetHypervisorInfo pour déterminer si un hyperviseur est présent sur le système.
Lorsque la fonction NdisGetHypervisorInfo retourne, le paramètre HypervisorInfo contient un pointeur vers une structure NDIS_HYPERVISOR_INFO. Cette structure contient des informations sur la présence d’un hyperviseur, ainsi que le type de partition à partir duquel cette fonction a été appelée. La structure NDIS_HYPERVISOR_INFO fournit ces informations de la manière suivante :
- Si un hyperviseur est présent, l’indicateur NDIS_HYPERVISOR_INFO_FLAG_HYPERVISOR_PRESENT est défini dans le membre des indicateurs de.
-
Si l’hyperviseur Microsoft est présent, le membre PartitionType est défini sur l’une des valeurs suivantes :
- Si la fonction NdisGetHypervisorInfo a été appelée à partir du système d’exploitation de gestion qui s’exécute dans la partition parente Hyper-V, le membre PartitionType est défini sur NdisHypervisorPartitionTypeMsHvParent.
- Si la fonction NdisGetHypervisorInfo a été appelée à partir du système d’exploitation invité qui s’exécute dans la partition enfant Hyper-V, le membre PartitionType est défini sur NdisHypervisorPartitionMsHvChild.
- Si l’hyperviseur d’un autre fournisseur est présent, le membre PartitionType est défini sur NdisHypervisorPartitionTypeUnknown.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge dans NDIS 6.0 et versions ultérieures. |
| plateforme cible | Universel |
| d’en-tête | ndis.h (include Ndis.h) |
| bibliothèque | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |