Verwalten von Informationen zum Status des benutzerdefinierten Switch-Features
Die erweiterbare Hyper-V-Switch-Schnittstelle verwendet den folgenden Objektbezeichner (OID), um benutzerdefinierte status Informationen für den erweiterbaren Switch abzufragen. Diese status Informationen werden als Switch-Feature status Informationen bezeichnet:
OID_SWITCH_FEATURE_STATUS_QUERY
Diese OID-Methodenanforderung wird vom Protokollrand des erweiterbaren Switches ausgegeben, um das benutzerdefinierte Feature status Informationen für eine angegebene Switcheigenschaft abzurufen.
Nach erfolgreicher Rückgabe dieser OID-Methodenanforderung enthält das InformationBuffer-Element 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 das benutzerdefinierte Feature status informationen angibt, die zurückgegeben werden sollen.
Hinweis Für ein benutzerdefiniertes Feature status ist das FeatureStatusType-Element auf NdisSwitchPropertyTypeCustom festgelegt.
Eine NDIS_SWITCH_FEATURE_STATUS_CUSTOM-Struktur, die die status Informationen zu einer benutzerdefinierten Eigenschaft enthält, die einem erweiterbaren Switchport zugewiesen ist.
Wenn der Protokollrand des erweiterbaren Switches die OID_SWITCH_FEATURE_STATUS_QUERY-Anforderung ausgibt, legt er die Elemente FeatureStatusCustomBufferLength und FeatureStatusCustomBufferOffset auf einen Speicherort im InformationBuffer-Member fest, mit dem die Erweiterung das Feature status Informationen zurückgeben kann.
Die erweiterbare Switcherweiterung muss die folgenden Richtlinien befolgen, wenn sie eine OID-Methodenanforderung von OID_SWITCH_FEATURE_STATUS_QUERY empfängt:
Die Erweiterung muss die OID-Anforderung verarbeiten, wenn sie ein benutzerdefiniertes erweiterbares Switch-Feature status verwaltet, das dem FeatureStatusId-Member der NDIS_SWITCH_FEATURE_STATUS_PARAMETERS-Struktur entspricht.
Wenn die Erweiterung die OID-Methodenanforderung verarbeitet, muss sie das Feature status Informationen zurückgeben, die den parametern entsprechen, die von der NDIS_SWITCH_FEATURE_STATUS_PARAMETERS-Struktur angegeben sind.
Wenn das Feature status Puffer zu klein ist, muss die Erweiterung die OID-Anforderung mit NDIS_STATUS_INVALID_LENGTH. Die Erweiterung muss data festlegen . SET_INFORMATION. BytesNeed-Member in der NDIS_OID_REQUEST-Struktur auf die erforderliche Mindestpuffergröße.
Andernfalls muss die Erweiterung das Feature status Informationen zurückgeben und die OID-Anforderung mit NDIS_STATUS_SUCCESS abschließen.
Wenn die Erweiterung das benutzerdefinierte erweiterbare Switch-Feature status nicht verwaltet, muss sie NdisFOidRequest aufrufen, um die OID-Anforderung über den erweiterbaren Switchtreiberstapel weiterzuleiten.
Weitere Informationen zum Weiterleiten von OID-Anforderungen finden Sie unter Filtern von OID-Anforderungen in einem NDIS-Filtertreiber.
Weitere Informationen zum Definieren und Registrieren des Switchfeatures status Informationen finden Sie unter Status des benutzerdefinierten Switch-Features.