NdisGetHypervisorInfo-Funktion (ndis.h)

  • Artikel
Wichtig  

Ab Windows 10 Version 1703 ist NdisGetHypervisorInfo veraltet und sollte nicht verwendet werden. Treiber werden empfohlen, sich davon zu entfernen, da es in zukünftigen Versionen des Betriebssystems möglicherweise nicht verfügbar ist.

Treiber sollten stattdessen die Anweisungen eines Hypervisors befolgen, um das Vorhandensein und die Funktionen des Hypervisors abzufragen. Die Anweisungen von Hyper-V sind beispielsweise in der Funktionsspezifikation der obersten Ebene dokumentiert.

Die NdisGetHypervisorInfo-Funktion gibt Informationen zum Hypervisor zurück, der auf dem System vorhanden ist.

Syntax

NDIS_STATUS NdisGetHypervisorInfo(
  [in, out] PNDIS_HYPERVISOR_INFO HypervisorInfo
);

Parameter

[in, out] HypervisorInfo

Ein Zeiger auf eine vom Aufrufer zugewiesene NDIS_HYPERVISOR_INFO Struktur, die Informationen zum Hypervisor enthält, der im System vorhanden ist.

Rückgabewert

NdisGetHypervisorInfo kann einen der folgenden status-Werte zurückgeben:

Rückgabecode Beschreibung
NDIS_STATUS_SUCCESS
 Der Vorgang wurde erfolgreich abgeschlossen.
NDIS_STATUS_BUFFER_TOO_SHORT
 Die Größe des Eingabeparameterpuffers war zu klein.

Hinweise

NDIS-Miniporttreiber rufen die NdisGetHypervisorInfo-Funktion auf, um zu bestimmen, ob ein Hypervisor im System vorhanden ist.

Wenn die NdisGetHypervisorInfo-Funktion zurückgibt, enthält der HypervisorInfo-Parameter einen Zeiger auf eine NDIS_HYPERVISOR_INFO-Struktur . Diese Struktur enthält Informationen darüber, ob ein Hypervisor vorhanden ist, zusammen mit dem Partitionstyp, von dem aus diese Funktion aufgerufen wurde. Die NDIS_HYPERVISOR_INFO-Struktur stellt diese Informationen auf folgende Weise bereit:

  • Wenn ein Hypervisor vorhanden ist, wird das flag NDIS_HYPERVISOR_INFO_FLAG_HYPERVISOR_PRESENT im Flags-Element festgelegt.
  • Wenn der Microsoft-Hypervisor vorhanden ist, wird der PartitionType-Member auf einen der folgenden Werte festgelegt:
    • Wenn die NdisGetHypervisorInfo-Funktion vom Verwaltungsbetriebssystem aufgerufen wurde, das in der übergeordneten Hyper-V-Partition ausgeführt wird, wird das PartitionType-Element auf NdisHypervisorPartitionTypeMsHvParent festgelegt.
    • Wenn die NdisGetHypervisorInfo-Funktion vom Gastbetriebssystem aufgerufen wurde, das in der untergeordneten Hyper-V-Partition ausgeführt wird, wird das PartitionType-Element auf NdisHypervisorPartitionMsHvChild festgelegt.
  • Wenn der Hypervisor eines anderen Anbieters vorhanden ist, wird das PartitionType-Element auf NdisHypervisorPartitionTypeUnknown festgelegt.
Hinweis Ein Treiber muss den Headermember der NDIS_HYPERVISOR_INFO-Struktur initialisieren, bevor er die NdisGetHypervisorInfo-Funktion aufruft.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.0 und höher.
Zielplattform Universell
Header ndis.h (include Ndis.h)
Bibliothek Ndis.lib
IRQL <= DISPATCH_LEVEL

Weitere Informationen

NDIS_HYPERVISOR_INFO