OID_SWITCH_NIC_DELETE

Hyper-v 拡張可能スイッチのプロトコルエッジは、OID_SWITCH_NIC_DELETE のオブジェクト識別子 (OID) セット要求を拡張可能なスイッチドライバースタックに発行します。 この OID 要求は、拡張可能なスイッチポートとネットワークアダプター間の接続の削除について、基になる拡張可能なスイッチ拡張機能に通知します。 拡張スイッチのプロトコルエッジは、 OID_SWITCH_NIC_DISCONNECTの OID セット要求を発行したときに、この接続が削除されていることを示す拡張機能を通知しました。

NDIS_OID_REQUEST構造体のinformationbufferメンバーには、 NDIS_SWITCH_NIC_PARAMETERS構造体へのポインターが含まれています。

コメント

NDIS_SWITCH_NIC_PARAMETERS構造体のポート idメンバーは、削除通知を行うポートを指定します。 拡張可能なスイッチ拡張機能は、 OID_SWITCH_PORT_ARRAYの OID クエリ要求を発行することによって、拡張可能スイッチ上のこのポートとその他のポートのパラメーター情報を取得できます。

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

拡張可能スイッチのプロトコルエッジが OID_SWITCH_NIC_DELETE 要求を発行する前に、指定されたネットワークアダプター接続に対するすべての保留中の送信または受信パケット要求が完了したことを保証します。 また、プロトコルエッジは、アダプター接続に対するすべての保留中の OID 要求が完了していること、およびアダプター接続の拡張可能なスイッチ参照カウンターの値が0であることも保証します。

メモ 拡張機能によって、参照可能なネットワークアダプターに対して拡張可能なスイッチ参照カウンターがインクリメントされた場合、参照カウンターが 0 以外の場合、OID_SWITCH_NIC_DELETE 要求は発行されません。 拡張機能は、 DereferenceSwitchNicを呼び出すことによって拡張可能なスイッチ参照カウンターをデクリメントします。

この拡張機能は、次のガイドラインに従って OID_SWITCH_NIC_DELETE の OID セット要求を処理する必要があります。

  • 拡張機能では、OID 要求に関連付けられている NDIS_SWITCH_NIC_PARAMETERS 構造を変更することはできません。

  • 拡張機能は、常にこの OID セット要求を基になる拡張機能に転送する必要があります。 拡張機能は要求を完了できません。

  • 拡張機能は、OID_SWITCH_NIC_DELETE の独自の OID セット要求を発行することはできません。

  • 拡張可能スイッチの外部ネットワークアダプターは、1つまたは複数の基になる物理アダプターにバインドできます。 外部ネットワークアダプターにバインドされているすべての物理ネットワークアダプターについて、拡張可能スイッチのプロトコルエッジは、OID_SWITCH_NIC_DELETE の個別の OID セット要求を発行します。 各 OID セット要求は、別のネットワークアダプター接続のインデックス値を指定します。 これらのインデックス値の詳細については、「 ネットワークアダプターのインデックス値」を参照してください。

    拡張機能は、基になる物理アダプターごとに接続状態を維持する必要があります。 物理ネットワークアダプターを外部ネットワークアダプターにバインドできるさまざまな構成の詳細については、「 物理ネットワークアダプターの構成の種類」を参照してください。

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

ステータスコードを返す

拡張可能スイッチの基になるミニポートエッジは、OID_SWITCH_NIC_DELETE の OID クエリ要求を完了し、次のステータスコードを返します。

状態コード 説明

NDIS_STATUS_SUCCESS

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

必要条件

Version

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

Header

Ntddndis (Ndis .h を含む)

関連項目


DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_PORT_ARRAY

上書き/Nic