OID_SWITCH_NIC_UPDATED

Hyper-V 拡張可能スイッチのプロトコル エッジは、拡張可能スイッチ ドライバー スタックに OID_SWITCH_NIC_UPDATED のオブジェクト識別子 (OID) セット要求を発行します。 この OID 要求は、ネットワーク アダプターのパラメーターの更新について、下位拡張可能スイッチ拡張機能に通知します。 OID は、既に接続されていて、まだ切断プロセスを開始していない NIC に対してのみ発行されます。 これらのランタイム構成の変更には、 NicFriendlyNameNetCfgInstanceIdMTUNumaNodeIdPermanentMacAddressVMMacAddressCurrentMacAddress および VFAssigned を含めることができます。

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

解説

NDIS_SWITCH_NIC_PARAMETERS 構造体の PortId メンバーは、更新通知を行う拡張可能スイッチ ポートを指定します。 拡張可能スイッチ拡張機能は、 OID_SWITCH_PORT_ARRAY の OID クエリ要求を発行することで、拡張可能スイッチのこれと他のポートのパラメーター情報を取得できます。

NDIS_SWITCH_NIC_PARAMETERS 構造体の Index メンバーが、更新続通知の行われているネットワーク アダプターのインデックスを指定します。 指定された Index 値を持つネットワーク アダプターは、 PortId メンバーによって指定された拡張可能スイッチ ポートに接続されます。 これらのインデックス値の詳細については、 ネットワーク アダプターのインデックス値 を参照してください。

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

  • 拡張機能は、OID 要求に関連付けられている NDIS_SWITCH_NIC_PARAMETERS 構造体を変更することはできません。
  • 拡張機能は、この OID セット要求を下位拡張機能に常に転送する必要があります。 拡張機能は要求を完了してはなりません。
  • 注 拡張機能は、OID_SWITCH_NIC_UPDATED の独自の OID セット要求を発行することはできません。

状態コードを返します

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

状態コード 説明

NDIS_STATUS_SUCCESS

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

要件

バージョン

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

ヘッダー

Ntddndis.h (Ndis.h を含む)

関連項目


DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_PORT_ARRAY

ReferenceSwitchNic