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