Funzione NdisGetHypervisorInfo (ndis.h)
A partire da Windows 10 versione 1703, NdisGetHypervisorInfo è deprecato e non deve essere usato. I driver sono invitati a allontanarsi da esso, in quanto potrebbero non essere disponibili nelle versioni future del sistema operativo.
I driver devono invece seguire le istruzioni di un hypervisor per eseguire query sulla presenza e sulle funzionalità dell'hypervisor. Ad esempio, le istruzioni di Hyper-V sono documentate nella specifica funzionale di primo livello.
La funzione NdisGetHypervisorInfo restituisce informazioni sull'hypervisor presente nel sistema.
Sintassi
NDIS_STATUS NdisGetHypervisorInfo(
[in, out] PNDIS_HYPERVISOR_INFO HypervisorInfo
);
Parametri
[in, out] HypervisorInfo
Puntatore a una struttura di NDIS_HYPERVISOR_INFO allocata dal chiamante che contiene informazioni sull'hypervisor presente nel sistema.
Valore restituito
NdisGetHypervisorInfo può restituire uno dei valori di stato seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Operazione riuscita. |
|
Le dimensioni del buffer dei parametri di input sono troppo piccole. |
Commenti
I driver miniport NDIS chiamano la funzione NdisGetHypervisorInfo per determinare se un hypervisor è presente nel sistema.
Quando viene restituita la funzione NdisGetHypervisorInfo , il parametro HypervisorInfo contiene un puntatore a una struttura NDIS_HYPERVISOR_INFO . Questa struttura contiene informazioni sul fatto che sia presente un hypervisor, insieme al tipo di partizione da cui è stata chiamata questa funzione. La struttura NDIS_HYPERVISOR_INFO fornisce queste informazioni nel modo seguente:
- Se è presente un hypervisor, il flag NDIS_HYPERVISOR_INFO_FLAG_HYPERVISOR_PRESENT viene impostato nel membro Flags .
-
Se l'hypervisor Microsoft è presente, il membro PartitionType viene impostato su uno dei valori seguenti:
- Se la funzione NdisGetHypervisorInfo è stata chiamata dal sistema operativo di gestione in esecuzione nella partizione padre Hyper-V, il membro PartitionType viene impostato su NdisHypervisorPartitionTypeMsHvParent.
- Se la funzione NdisGetHypervisorInfo è stata chiamata dal sistema operativo guest in esecuzione nella partizione figlio Hyper-V, il membro PartitionType viene impostato su NdisHypervisorPartitionMsHvChild.
- Se è presente l'hypervisor di un altro fornitore, il membro PartitionType viene impostato su NdisHypervisorPartitionTypeUnknown.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato in NDIS 6.0 e versioni successive. |
| Piattaforma di destinazione | Universale |
| Intestazione | ndis.h (include Ndis.h) |
| Libreria | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |