Hyper-V 拡張可能スイッチのプロトコル エッジは、拡張可能スイッチ ポートとネットワーク アダプターの間のネットワーク接続が完全に確立されたことを基になる拡張可能スイッチ拡張機能に通知するために、OID_SWITCH_NIC_CONNECTのオブジェクト識別子 (OID) セット要求を発行します。 プロトコル エッジは、OID_SWITCH_NIC_CREATEの OID セット要求を発行したときに、この接続が確立されていることを拡張機能に以前に通知しました。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_SWITCH_NIC_PARAMETERS 構造体へのポインターが含まれています。
備考
NDIS_SWITCH_NIC_PARAMETERS 構造体の PortId メンバーは、接続通知を行う拡張可能スイッチ ポートを指定します。 拡張可能スイッチ拡張機能は、次の方法で、このポートとその他の拡張可能スイッチ ポートのパラメーター情報を取得できます。
OID_SWITCH_PORT_ARRAYの OID クエリ要求を発行する。 この拡張機能は、IsActive が TRUE に設定された NDIS_SWITCH_PARAMETERS 構造体OID_SWITCH_PARAMETERS返す場合にのみ、FilterAttach でこの OID を発行します。 IsActive が FALSE の場合、拡張機能は、拡張ミニポート アダプターによって NetEventSwitchActivateNET_PNP_EVENT が発行されたときに OID を発行します。
さまざまな OID セットの OID_SWITCH_PORT_CREATE と OID_SWITCH_PORT_DELETEの要求を調べることで、
NDIS_SWITCH_NIC_PARAMETERS 構造体の Index メンバーは、接続通知が行われているネットワーク アダプターのインデックスを指定します。 指定した Index 値を持つネットワーク アダプターは、PortId メンバーによって指定された拡張可能スイッチ ポートに接続されます。 これらのインデックス値の詳細については、「ネットワーク アダプターのインデックス値 を参照してください。
OID_SWITCH_NIC_CONNECTの OID セット要求を受信すると、拡張機能は次のガイドラインに従う必要があります。
NDIS_STATUS_SUCCESSでOID_SWITCH_NIC_CONNECT要求が完了すると、ネットワーク接続と拡張可能スイッチ ポートが完全に動作します。 拡張機能は、ポートのネットワーク接続にパケット トラフィックを生成または転送できます。 拡張機能では、ポートをソース ポートとして使用する拡張可能スイッチ 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 を含む) |
関連項目
NdisFReturnNetBufferListsの
NdisFOidRequestの
ReferenceSwitchPortの