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:
Eine NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS-Struktur , die die Parameter für die erweiterbare Switchrichtlinienaufzählung angibt.
Ein Array von NDIS_SWITCH_PROPERTY_ENUM_INFO Strukturen. Jede dieser Strukturen enthält Informationen zu einer erweiterbaren Switchrichtlinie.
Hinweis Wenn die Erweiterung nicht mit Instanzen der angegebenen erweiterbaren Switchrichtlinie bereitgestellt wurde, legt die Erweiterung den NumProperties-Member der NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS-Struktur auf Null fest, und es werden keine NDIS_SWITCH_PROPERTY_ENUM_INFO-Strukturen zurückgegeben.
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_SWITCH_PROPERTY_ENUM_INFO
NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS
Abfragen der Konfiguration des erweiterbaren Hyper-V-Switches