Verwalten von Informationen zum Status des benutzerdefinierten Switch-Features

  • Artikel

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.