Freigeben über

NdisGetHypervisorInfo-Funktion (ndis.h)

  • Artikel
Wichtige  

Ab Windows 10 Version 1703 ist NdisGetHypervisorInfo veraltet und sollte nicht verwendet werden. Treiber werden ermutigt, 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 die Anwesenheit und Funktionen des Hypervisors abzufragen. Die Anweisungen von Hyper-V werden beispielsweise in der Top-Level Funktionale Spezifikationdokumentiert.

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 Statuswerte 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.

Bemerkungen

NDIS miniport drivers call the NdisGetHypervisorInfo function to determine whether a hypervisor is present on the system.

Wenn die NdisGetHypervisorInfo-funktion zurückgibt, enthält der HypervisorInfo Parameter einen Zeiger auf eine NDIS_HYPERVISOR_INFO Struktur. Diese Struktur enthält Informationen dazu, ob ein Hypervisor vorhanden ist, sowie den Partitionstyp, aus dem diese Funktion aufgerufen wurde. Die NDIS_HYPERVISOR_INFO Struktur stellt diese Informationen wie folgt bereit:

  • Wenn ein Hypervisor vorhanden ist, wird das NDIS_HYPERVISOR_INFO_FLAG_HYPERVISOR_PRESENT Flag im Flags Member 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 partition Hyper-V ausgeführt wird, wird der PartitionType Member auf NdisHypervisorPartitionTypeMsHvParentfestgelegt.
    • Wenn die NdisGetHypervisorInfo Funktion vom Gastbetriebssystem aufgerufen wurde, das in der untergeordneten Hyper-V Partition ausgeführt wird, wird der PartitionType Member auf NdisHypervisorPartitionMsHvChildfestgelegt.
  • Wenn der Hypervisor eines anderen Anbieters vorhanden ist, wird der PartitionType Member auf NdisHypervisorPartitionTypeUnknownfestgelegt.
Hinweis Ein Treiber muss das Header Member der NDIS_HYPERVISOR_INFO Struktur initialisieren, bevor er die NdisGetHypervisorInfo Funktion aufruft.
 

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Unterstützt in NDIS 6.0 und höher.
Zielplattform- Universal
Header- ndis.h (include Ndis.h)
Library Ndis.lib
IRQL- <= DISPATCH_LEVEL

Siehe auch

NDIS_HYPERVISOR_INFO