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:
Eine NDIS_SWITCH_PORT_ARRAY-Struktur , die die Anzahl der Elemente innerhalb des Arrays definiert.
Ein Array von NDIS_SWITCH_PORT_PARAMETERS Strukturen. Jede dieser Strukturen enthält Informationen zu einem Port auf dem erweiterbaren Switch.
Hinweis Wenn keine Ports für den erweiterbaren Switch erstellt wurden, legt der Treiber den NumElements-Member der NDIS_SWITCH_PORT_ARRAY-Struktur auf Null fest, und es werden keine NDIS_SWITCH_PORT_PARAMETERS-Strukturen zurückgegeben.
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
Abfragen der Konfiguration des erweiterbaren Hyper-V-Switches