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) |