Freigeben über


OID_SWITCH_PARAMETERS

Eine erweiterungsfähige Hyper-V-Switch-Erweiterung gibt eine Objektbezeichnerabfrageanforderung (Object Identifier, OID) von OID_SWITCH_PARAMETERS aus, um die Konfigurationsdaten des erweiterbaren Switches abzurufen.

Wenn die OID-Abfrageanforderung erfolgreich abgeschlossen wurde, enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_SWITCH_PARAMETERS-Struktur .

Bemerkungen

Wenn die Erweiterung die zurückgegebene NDIS_SWITCH_PARAMETERS-Struktur verarbeitet, darf nicht davon ausgegangen werden, dass die verschiedenen Zeichenfolgenmember der NDIS_SWITCH_PARAMETERS-Struktur , z. B. SwitchName, NULL-beendet sind. Die Datentypen für diese Zeichenfolgenmember werden von der IF_COUNTED_STRING-Struktur typdefiniert. Die Erweiterung muss die Zeichenfolgenlänge aus dem Wert des Length-Members dieser Struktur bestimmen.

Hinweis Wenn die Zeichenfolge null-beendet ist, darf das Length-Element das beendende NULL-Zeichen nicht enthalten.

Rückgabestatuscodes

Der zugrunde liegende Miniportrand des erweiterbaren Switches schließt die OID-Abfrageanforderung von OID_SWITCH_PARAMETERS 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 OID_SWITCH_PARAMETERS Struktur für eine OID-Abfrageanforderung zurückzugeben. Der zugrunde liegende Miniportrand des erweiterbaren Switches legt die DATA fest . QUERY_INFORMATION. BytesNeed-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_PARAMETERS

NdisFOidRequest