OID_SWITCH_PORT_ARRAY

Eine erweiterbare Hyper-V-Switcherweiterung gibt eine OID-Abfrageanforderung (Object Identifier) von OID_SWITCH_PORT_ARRAY aus, um ein Array abzurufen. Jedes Element im Array gibt die Konfigurationsparameter für einen erweiterbaren Switchport an.

Wenn die OID-Abfrageanforderung erfolgreich abgeschlossen wird, enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf einen Puffer. Dieser Puffer enthält die folgenden Daten:

Bemerkungen

Die OID_SWITCH_PORT_ARRAY 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 .

Wenn die Erweiterung die zurückgegebene NDIS_SWITCH_PORT_PARAMETERS-Struktur verarbeitet, darf sie nicht davon ausgehen, dass die verschiedenen Zeichenfolgenmember der NDIS_SWITCH_PORT_PARAMETERS-Struktur , z. B. PortName, NULL-beendet sind. Die Datentypen für diese Zeichenfolgenmember werden vom Typ der IF_COUNTED_STRING-Struktur definiert. Der Treiber muss die Zeichenfolgenlänge aus dem Wert des Length-Elements dieser Struktur bestimmen.

Hinweis Wenn die Zeichenfolge NULL-endend ist, darf der Length-Member nicht das abschließende NULL-Zeichen enthalten.

Zurückgeben von Statuscodes

Der zugrunde liegende Miniportrand des erweiterbaren Schalters schließt die OID-Abfrageanforderung von OID_SWITCH_PORT_ARRAY 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 den NDIS_SWITCH_PORT_ARRAY und sein Array von NDIS_SWITCH_PORT_PARAMETERS Elementen zurückzugeben. Der zugrunde liegende Miniportrand des erweiterbaren Schalters legt die DATEN fest. QUERY_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_PORT_ARRAY

NDIS_SWITCH_PORT_PARAMETERS

Abfragen der Konfiguration des erweiterbaren Hyper-V-Switches