OID_SWITCH_NIC_CONNECT
Hyper-V 拡張可能スイッチのプロトコル エッジは、拡張可能スイッチ ポートとネットワーク アダプターの間のネットワーク接続が完全に確立されたことを、下位拡張可能スイッチ拡張機能に通知する OID_SWITCH_NIC_CONNECT のオブジェクト識別子 (OID) セット要求を発行します。 プロトコル エッジは、 OID_SWITCH_NIC_CREATE の OID セット要求を発行したときに、この接続が確立されていることを拡張機能に以前に通知しました。
NDIS_SWITCH_NIC_PARAMETERS 構造体の InformationBuffer メンバーには、 NDIS_NIC_SWITCH_PARAMETERS 構造体を指すポインターが含まれています。
解説
NDIS_SWITCH_NIC_PARAMETERS 構造体の PortId メンバーは、接続通知を行う拡張可能スイッチ ポートを指定します。 拡張可能スイッチ拡張機能は、次の方法で、このポートとその他の拡張可能スイッチ ポートのパラメーター情報を取得できます：
OID_SWITCH_PORT_ARRAY の OID クエリ要求を発行することによって。 拡張機能は、 IsActive が TRUE に設定された NDIS_SWITCH_PARAMETERS 構造体を OID_SWITCH_PARAMETERS が返す場合にのみ、 FilterAttach でこの OID を発行します。 IsActive が FALSE の場合、拡張ミニポート アダプターによって NetEventSwitchActivate NET_PNP_EVENT が発行されたときに、拡張機能によって OID が発行されます。
OID_SWITCH_PORT_CREATE と OID_SWITCH_PORT_DELETE さまざまな OID セットのを検査することによって。
NDIS_SWITCH_NIC_PARAMETERS 構造体の Index メンバーが、接続通知の行われているネットワーク アダプターのインデックスを指定します。 指定された Index 値を持つネットワーク アダプターは、 PortId メンバーによって指定された拡張可能スイッチ ポートに接続されます。 これらのインデックス値の詳細については、 ネットワーク アダプターのインデックス値 を参照してください。
OID_SWITCH_NIC_CONNECTの OID セット要求を受信すると、拡張機能は次のガイドラインに従う必要があります：
OID_SWITCH_NIC_CONNECT 要求が NDIS_STATUS_SUCCESS で完了すると、ネットワーク接続と拡張可能スイッチ・ポートは完全に作動可能になります。 拡張機能は、ポートのネットワーク接続にパケット トラフィックを生成または転送できます。 拡張機能では、ポートをソース ポートとして使用する拡張可能スイッチ OID または状態表示を発行することもできます。 拡張機能は、 ReferenceSwitchPort を呼び出して、ポートの拡張可能スイッチ参照カウンターをインクリメントすることもできます。
拡張機能は、OID 要求に関連付けられている NDIS_SWITCH_NIC_PARAMETERS 構造体を変更することはできません。
この OID 要求を下位拡張機能に転送するには、拡張機能は常に NdisFOidRequest を呼び出す必要があります 拡張機能は、OID 要求自体を完了してはなりません。
拡張可能スイッチ外部ネットワーク アダプターは、1つ以上の下位物理アダプターにバインドできます。 外部ネットワーク アダプターにバインドされているすべての物理ネットワーク アダプターについて、拡張可能スイッチのプロトコル エッジは、OID_SWITCH_NIC_CONNECT の個別 OID 設定要求を発行します。 各 OID セット要求は、異なるネットワーク アダプター接続インデックス値を指定します。 これらのインデックス値の詳細については、 ネットワーク アダプターのインデックス値を参照してください。
拡張機能は、外部ネットワーク アダプターにバインドされている各下位物理アダプターの接続状態を保持する必要があります。 物理ネットワーク アダプターを外部ネットワーク アダプターにバインドできるさまざまな構成の詳細については、 物理ネットワーク アダプター構成の種類 を参照してください。
注 拡張機能は、OID_SWITCH_NIC_CONNECT の独自の OID セット要求を発行することはできません。
拡張可能スイッチ ポートとネットワーク アダプター接続の状態の詳細については、 Hyper-V 拡張可能スイッチ ポートとネットワーク アダプターの状態 を参照してください。
状態コードを返します
拡張可能スイッチの下位ミニポート エッジは、OID_SWITCH_NIC_CONNECT の OID セット要求を完了し、次のいずれかの状態コードを返します。
| 状態コード | 説明 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求は正常に完了しました。 |
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |