OID_SWITCH_PORT_UPDATED

  • [アーティクル]

Hyper-V 拡張可能スイッチのプロトコル エッジは、拡張可能スイッチ ポートの更新について拡張可能スイッチ拡張機能に通知する OID_SWITCH_PORT_UPDATED のオブジェクト識別子 (OID) セット要求を発行します。 OID は、既に作成されており、破棄／削除プロセスをまだ開始していないポートに対してのみ発行されます。 現在は、 PortFriendlyName フィールドのみが作成後に更新される可能性があります。

NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、 NDIS_SWITCH_NIC_SAVE_STATE 構造体を指すポインターが含まれています。

解説

NDIS_SWITCH_PORT_PARAMETERS 構造体の PortId メンバーは、更新通知を行う拡張可能スイッチ ポートを指定します。

拡張機能は、OID_SWITCH_PORT_UPDATED の OID セット要求を処理するために、次のガイドラインに従う必要があります：

  • 拡張機能は、OID 要求に関連付けられている NDIS_SWITCH_PORT_PARAMETERS 構造体を変更してはなりません。

  • 拡張機能は、この OID セット要求を下位拡張機能に常に転送する必要があります。 拡張機能はこの要求に失敗してはなりません。

注 拡張可能スイッチ拡張機能は、OID_SWITCH_PORT_UPDATED の OID セット要求を発行できません。

拡張可能スイッチ ポートとネットワーク アダプター接続の状態の詳細については、 Hyper-V 拡張可能スイッチ ポートとネットワーク アダプターの状態 を参照してください。

状態コードを返します

拡張可能スイッチの下位ミニポート エッジは、OID_SWITCH_PORT_UPDATED の OID セット要求を完了し、次のいずれかの状態コードを返します。

状態コード 説明

NDIS_STATUS_SUCCESS

OID 要求は正常に完了しました。

要件

バージョン

NDIS 6.30 以降でサポートされています。

ヘッダー

 Ntddndis.h (Ndis.h を含む)

関連項目

DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchNic