NdisGetHypervisorInfo-Funktion (ndis.h)
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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
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.
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 |