OID_SWITCH_NIC_DISCONNECT
Hyper-V 拡張可能スイッチのプロトコル エッジは、拡張可能スイッチ ポートとネットワーク アダプターの間の接続が切断されていることを、下位拡張可能スイッチ拡張機能に通知する OID_SWITCH_NIC_DISCONNECT のオブジェクト識別子 (OID) セット要求を発行します。 接続が完全に切断されると、拡張可能スイッチのプロトコル エッジは、 OID_SWITCH_NIC_DELETE の OID セット要求を発行することになります。
NDIS_SWITCH_NIC_PARAMETERS 構造体の InformationBuffer メンバーには、 NDIS_NIC_SWITCH_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_REQUEST の OID 要求を、OID_SWITCH_NIC_DISCONNECT OID 要求が発行された下位ネットワーク アダプターに転送または発信します。
注 拡張機能が、 ReferenceSwitchNic を呼び出して、OID_SWITCH_NIC_DISCONNECT が発行される前に拡張可能スイッチ参照カウンターをインクリメントした場合でも、拡張機能は OID 要求を転送または発信できます。
OID_SWITCH_NIC_DISCONNECT OID 要求が発行された下位ネットワーク アダプターから、 NDIS_STATUS_SWITCH_NIC_STATUS の NDIS 状態表示を転送または発信します。
注 拡張機能が、 ReferenceSwitchNic を呼び出して、OID_SWITCH_NIC_DISCONNECT が発行される前に拡張可能スイッチ参照カウンターをインクリメントした場合でも、拡張機能は NDIS 状態表示を転送または発信できます。
注 拡張機能は、スイッチ参照カウンターをインクリメントする前に ReferenceSwitchNic を呼び出しす場合、OID 要求や NDIS 状態表示を発信または転送するための呼び出しを、 Hyper-V 拡張可能スイッチ OID 要求を管理するコードと同期する必要はありません。 拡張機能が参照カウンターをインクリメントした後、拡張可能スイッチ インターフェイスは、 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 を含む) |