Freigeben über


OID_SWITCH_PARAMETERS

Eine Hyper-V erweiterbare Switcherweiterung gibt eine OID-Abfrageanforderung (Object Identifier) von OID_SWITCH_PARAMETERS aus, um die Konfigurationsdaten des erweiterbaren Switches abzurufen.

Wenn die OID-Abfrageanforderung erfolgreich abgeschlossen wird, 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 Zeichenfolgenmmber der NDIS_SWITCH_PARAMETERS-Struktur, z. B. SwitchName-, null-beendet sind. Die Datentypen für diese Zeichenfolgenmmber werden durch die IF_COUNTED_STRING Struktur definiert. Die Erweiterung muss die Zeichenfolgenlänge aus dem Wert des Length Member dieser Struktur bestimmen.

Hinweis Wenn die Zeichenfolge null beendet ist, darf das element Length das endende Nullzeichen nicht enthalten.

Rückgabestatuscodes

Der zugrunde liegende Miniportrand des erweiterbaren Schalters schließt die OID-Abfrageanforderung von OID_SWITCH_PARAMETERS ab und gibt einen der folgenden Statuscodes 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 Schalters legt den DATA fest. QUERY_INFORMATION. BytesNeededed Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.

NDIS_STATUS_FAILURE

Fehler bei der Anforderung aus anderen Gründen.

Anforderungen

Version

Unterstützt in NDIS 6.30 und höher.

Kopfball

Ntddndis.h (include Ndis.h)

Siehe auch


NDIS_OID_REQUEST

NDIS_SWITCH_PARAMETERS

NdisFOidRequest