Funzione NdisGetHypervisorInfo (ndis.h)

  • Articolo
Importante  

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
NDIS_STATUS_SUCCESS
 Operazione riuscita.
NDIS_STATUS_BUFFER_TOO_SHORT
 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.
Nota Un driver deve inizializzare il membro Header della struttura NDIS_HYPERVISOR_INFO prima di chiamare la funzione NdisGetHypervisorInfo .
 

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

Vedi anche

NDIS_HYPERVISOR_INFO