OID_SWITCH_PROPERTY_ENUM

Die Erweiterung des erweiterbaren Hyper-V-Switches gibt eine OID-Methodenanforderung (Object Identifier) von OID_SWITCH_PROPERTY_ENUM aus, um ein Array abzurufen. Dieses Array enthält die bereitgestellten Switchrichtlinien, die den angegebenen Kriterien entsprechen. Jedes Element im Array gibt die Eigenschaften einer erweiterbaren Switchrichtlinie an.

Der InformationBuffer-Member der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf einen Puffer. Dieser Puffer enthält die folgenden Daten:

Bemerkungen

Die OID_SWITCH_PROPERTY_ENUM OID darf nur ausgegeben werden, wenn die Aktivierung des erweiterbaren Hyper-V-Schalters abgeschlossen ist. Weitere Informationen finden Sie unter Abfragen der Konfiguration des erweiterbaren Hyper-V-Switches .

Im Gegensatz zu OID-Abfrageanforderungen von OID_SWITCH_PORT_PROPERTY_ENUM muss die Erweiterung keine ReferenceSwitchXxx - oder DereferenceSwitchXxx-Funktionen aufrufen, wenn sie die OID_SWITCH_PROPERTY_ENUM Anforderung im erweiterbaren Switchtreiberstapel ausgibt.

Hinweis Wenn die Erweiterung die OID-Methodenanforderung von OID_SWITCH_PROPERTY_ENUM empfängt, darf sie die OID-Anforderung nicht abschließen. Stattdessen muss NdisFOidRequest aufgerufen werden, um die OID-Anforderung über den erweiterbaren Switchtreiberstapel weiterzuleiten.

Zurückgeben von Statuscodes

Der zugrunde liegende Miniportrand des erweiterbaren Schalters schließt die OID-Abfrageanforderung von OID_SWITCH_PROPERTY_ENUM ab und gibt einen der folgenden status Codes zurück.

Statuscode BESCHREIBUNG

NDIS_STATUS_SUCCESS

Die OID-Anforderung wurde erfolgreich abgeschlossen.

NDIS_STATUS_INVALID_LENGTH

Die Länge des Informationspuffers ist zu klein, um die NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS-Struktur und deren Array von NDIS_SWITCH_PROPERTY_ENUM_INFO Elementen zurückzugeben. Der zugrunde liegende Miniportrand des erweiterbaren Schalters legt die DATEN fest. METHOD_INFORMATION. BytesNeeded-Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.

NDIS_STATUS_FAILURE

Die Anforderung ist aus anderen Gründen fehlgeschlagen.

Requirements (Anforderungen)

Version

Unterstützt in NDIS 6.30 und höher.

Header

Ntddndis.h (include Ndis.h)

Weitere Informationen


NDIS_OID_REQUEST

NDIS_SWITCH_PROPERTY_ENUM_INFO

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS

Abfragen der Konfiguration des erweiterbaren Hyper-V-Switches