Verwalten von Informationen zum Status des benutzerdefinierten Portfeatures
Die erweiterbare Hyper-V-Switch-Schnittstelle verwendet den folgenden Objektbezeichner (Object Identifier, OID), um benutzerdefinierte status Informationen für einen erweiterbaren Switchport abzufragen. Diese status Informationen werden als Portfeature status Informationen bezeichnet:
OID_SWITCH_PORT_FEATURE_STATUS_QUERY
Diese OID-Methodenanforderung wird vom Protokollrand des erweiterbaren Switches ausgegeben, um das benutzerdefinierte Feature status Informationen für eine angegebene Porteigenschaft 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_PORT_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 NdisSwitchPortPropertyTypeCustom festgelegt.
Eine NDIS_SWITCH_PORT_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_PORT_FEATURE_STATUS_QUERY-Anforderung ausgibt, legt er die Member FeatureStatusCustomBufferLength und FeatureStatusCustomBufferOffset auf einen Speicherort im InformationBuffer-Member fest, den die Erweiterung verwenden kann, um das Feature status Informationen zurückzugeben.
Die erweiterbare Switcherweiterung muss die folgenden Richtlinien befolgen, wenn sie eine OID-Methodenanforderung von OID_SWITCH_PORT_FEATURE_STATUS_QUERY empfängt:
Die Erweiterung muss die OID-Anforderung verarbeiten, wenn sie eine benutzerdefinierte erweiterbare Switchporteigenschaft verwaltet, die dem FeatureStatusId-Member der NDIS_SWITCH_PORT_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_PORT_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 die benutzerdefinierte erweiterbare Switch-Eigenschaft 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 Portfeatures status Informationen finden Sie unter Status des benutzerdefinierten Portfeatures.