OID_SWITCH_FEATURE_STATUS_QUERY
Der Protokollrand des erweiterbaren Hyper-V-Switches gibt eine OID-Methodenanforderung (Object Identifier) von OID_SWITCH_FEATURE_STATUS_QUERY aus, um benutzerdefinierte status Informationen aus einer Erweiterung über den erweiterbaren Switch abzurufen. Diese Informationen werden als Feature-status-Informationen bezeichnet. Das Format dieser Informationen wird vom unabhängigen Softwarehersteller (Independent Software Vendor, ISV) definiert.
Nach einer erfolgreichen Rückgabe von dieser OID-Methodenanforderung enthält der InformationBuffer-Member der NDIS_OID_REQUEST-Struktur einen Zeiger auf einen Puffer. Dieser Puffer enthält die folgenden Daten:
Eine NDIS_SWITCH_FEATURE_STATUS_PARAMETERS-Struktur, die die Parameter für den Typ der zurückzugebenden Status Informationen angibt.
Eine NDIS_SWITCH_FEATURE_STATUS_CUSTOM-Struktur, die das Feature status Informationen für den erweiterbaren Switch enthält.
Bemerkungen
Richtlinien zum Behandeln einer OID-Satzanforderung von OID_SWITCH_FEATURE_STATUS_QUERY finden Sie unter Verwalten des Featurestatus von benutzerdefinierten Switchen.
Zurückgeben von Statuscodes
Die Erweiterung gibt einen der folgenden status Codes für die OID-Methodenanforderung von OID_SWITCH_FEATURE_STATUS_QUERY 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 das Feature status Informationen sowie die NDIS_SWITCH_FEATURE_STATUS_CUSTOM- und NDIS_SWITCH_FEATURE_STATUS_PARAMETERS-Strukturen zurückzugeben. Der zugrunde liegende Miniportrand des erweiterbaren Schalters legt die DATEN fest. METHOD_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) |