OID_SWITCH_NIC_DISCONNECT
Hyper-V 拡張可能スイッチのプロトコル エッジは、OID_SWITCH_NIC_DISCONNECTのオブジェクト識別子 (OID) セット要求を発行して、拡張可能スイッチ ポートとネットワーク アダプターの間の接続が切断されていることを基になる拡張可能スイッチ拡張機能に通知します。 接続が完全に切断されると、拡張可能スイッチのプロトコル エッジは、OID_SWITCH_NIC_DELETEの OID セット要求を発行します。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_SWITCH_NIC_PARAMETERS 構造体へのポインターが含まれています。
備考
NDIS_SWITCH_NIC_PARAMETERS 構造体の Index メンバーは、切断通知が行われているネットワーク アダプターのインデックスを指定します。 指定した Index 値を持つネットワーク アダプターは、PortId メンバーによって指定された拡張可能スイッチ ポートに接続されます。 これらのインデックス値の詳細については、「ネットワーク アダプターのインデックス値 を参照してください。
拡張機能は、OID_SWITCH_NIC_DISCONNECTの OID セット要求を処理するときに、次のガイドラインに従う必要があります。
拡張機能は、OID 要求に関連付けられている NDIS_SWITCH_NIC_PARAMETERS 構造体を変更することはできません。
OID_SWITCH_NIC_DISCONNECT要求は、指定されたネットワーク アダプターと拡張可能スイッチ ポートの間で拡張可能スイッチ接続が切断されていることを拡張機能に通知するだけです。 拡張機能は、この OID 要求を処理した後、次の操作を行わないでください。
OID_SWITCH_NIC_DISCONNECT OID 要求が発行された拡張可能スイッチ ポートで、ネットワーク アダプター接続へのパケット トラフィックを生成します。
ReferenceSwitchNic呼び出して、拡張可能スイッチ ポートで指定されたネットワーク アダプター接続の拡張可能スイッチ参照カウンターをインクリメントします。
OID_SWITCH_NIC_DISCONNECT OID 要求が発行された基になるネットワーク アダプターに OID_SWITCH_NIC_REQUEST の OID 要求を転送または送信します。
注 OID_SWITCH_NIC_DISCONNECTが発行される前に、拡張スイッチ参照カウンターをインクリメントするために ReferenceSwitchNic呼び出された拡張機能は、OID 要求を転送または発信できます。
OID_SWITCH_NIC_DISCONNECT OID 要求が発行された基になるネットワーク アダプターからの NDIS_STATUS_SWITCH_NIC_STATUS の NDIS 状態表示を転送または発信します。
注 OID_SWITCH_NIC_DISCONNECTが発行される前に、拡張スイッチ参照カウンターをインクリメントするために ReferenceSwitchNic という拡張機能が 場合でも、拡張機能は NDIS 状態表示を転送または発信できます。
注 拡張スイッチ参照カウンターをインクリメントするために ReferenceSwitchNic呼び出された拡張機能の場合、OID 要求または NDIS 状態表示を、拡張可能スイッチ OID 要求を管理するコードと同期する必要 Hyper-V ありません。 拡張機能が参照カウンターをインクリメントした後、拡張可能スイッチ インターフェイスは、OID_SWITCH_NIC_DELETEの OID セット要求を発行しません。
拡張機能は、この OID セット要求を基になる拡張機能に常に転送する必要があります。 拡張機能が要求を完了してはなりません。
拡張可能スイッチ外部ネットワーク アダプターは、基になる 1 つ以上の物理アダプターにバインドできます。 外部ネットワーク アダプターにバインドされているすべての物理ネットワーク アダプターに対して、拡張可能スイッチのプロトコル エッジは、OID_SWITCH_NIC_DISCONNECTの個別の OID セット要求を発行します。 各 OID セット要求は、異なるネットワーク アダプター接続インデックス値を指定します。 これらのインデックス値の詳細については、「ネットワーク アダプターのインデックス値 を参照してください。
拡張機能は、基になる各物理アダプターの接続状態を維持する必要があります。 物理ネットワーク アダプターを外部ネットワーク アダプターにバインドできるさまざまな構成の詳細については、「物理ネットワーク アダプター構成の種類を参照してください。
注 拡張機能は、OID_SWITCH_NIC_DISCONNECTの独自の OID セット要求を発行してはなりません。
拡張可能スイッチ ポートとネットワーク アダプター接続の状態の詳細については、「Hyper-V 拡張可能スイッチ ポートとネットワーク アダプターの状態を参照してください。
戻り値の状態コード
拡張可能スイッチの基になるミニポート エッジは、OID_SWITCH_NIC_DISCONNECTの OID クエリ要求を完了し、次の状態コードを返します。
| 状態コード | 形容 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求が正常に完了しました。 |
必要条件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |
関連項目
ReferenceSwitchPortの