Hyper-V 拡張可能スイッチのプロトコル エッジは、拡張可能スイッチ ポートが削除プロセスを開始することを基になる拡張可能スイッチ拡張機能に通知するために、OID_SWITCH_PORT_TEARDOWNのオブジェクト識別子 (OID) セット要求を発行します。 このプロセスは、プロトコル ドライバーが OID_SWITCH_PORT_DELETEの OID セット要求を発行するときに開始されます。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_SWITCH_PORT_PARAMETERS 構造体へのポインターが含まれています。
備考
NDIS_SWITCH_PORT_PARAMETERS 構造体の PortId メンバーは、接続通知を行う拡張可能スイッチ ポートを指定します。 拡張可能スイッチ拡張機能は、次の方法で取得したポートに関するキャッシュされた情報を更新する必要があります。
OID_SWITCH_PORT_ARRAYの OID クエリ要求を発行する。 この拡張機能は、の FilterAttach でこの OID を発行 OID_SWITCH_PARAMETERS、isActive が TRUE に設定された NDIS_SWITCH_PARAMETERS 構造体を返す場合にのみ発生します。 IsActive が FALSE の場合、拡張機能は、NetEventSwitchActivateNET_PNP_EVENT が拡張機能ミニポートによって発行されたときに OID を発行します。
さまざまな OID セットの OID_SWITCH_PORT_CREATE と OID_SWITCH_PORT_DELETEの要求を調べることで、
拡張可能スイッチのプロトコル エッジは、ポートが拡張可能スイッチから削除処理中であることを拡張機能に通知するために、OID_SWITCH_PORT_TEARDOWNの OID セット要求を発行します。 この OID 要求が発行される前に、ポートにアクティブなネットワーク アダプター接続がある場合は、拡張可能スイッチのプロトコル エッジが以前に次の OID を発行していました。
OID_SWITCH_NIC_DISCONNECT:NDIS_SWITCH_PORT_PARAMETERS 構造体で指定されたポートにネットワーク アダプターが接続されなくなったことを基になる拡張機能に通知します。
OID_SWITCH_NIC_DELETE:ネットワーク アダプターと拡張可能スイッチ ポートの間のネットワーク接続が削除されたことを基になる拡張機能に通知します。
プロトコル エッジは、指定された拡張可能スイッチ ポートのすべての保留中のパケットが取り消されたか完了した後に、この OID セット要求を発行します。
拡張機能がこの OID セット要求を完了し、拡張可能スイッチ ポートの参照カウンターが 0 になると、拡張可能スイッチのプロトコル エッジは、OID_SWITCH_PORT_DELETEの OID セット要求を発行します。 この OID 要求は、拡張可能スイッチからポートを削除します。
注 拡張機能は、ReferenceSwitchPort呼び出すことによって拡張可能スイッチ ポートの参照カウンターをインクリメントします。 拡張機能は、dereferenceSwitchPort呼び出すことによって参照カウンターをデクリメントします。
拡張機能は、OID_SWITCH_PORT_TEARDOWNの OID セット要求を処理するために、次のガイドラインに従う必要があります。
拡張機能は、この OID セット要求を基になる拡張機能に常に転送する必要があります。 拡張機能は要求を失敗してはなりません。
注 拡張機能は、OID 要求に関連付けられている NDIS_SWITCH_PORT_PARAMETERS 構造体を変更することはできません。
拡張機能は、この OID 要求を転送した後、削除されたポートにパケットを転送できません。 また、拡張機能は、OID 要求を発行したり、削除されたポートの ReferenceSwitchPort 関数を呼び出したりすることもできません。
注 拡張機能は、OID_SWITCH_PORT_TEARDOWNの OID セット要求を発行してはなりません。
拡張可能スイッチ ポートとネットワーク アダプター接続の状態の詳細については、「Hyper-V 拡張可能スイッチ ポートとネットワーク アダプターの状態を参照してください。
戻り値の状態コード
拡張可能スイッチの基になるミニポート エッジは、OID_SWITCH_PORT_TEARDOWNの OID セット要求を完了し、次の状態コードを返します。
| 状態コード | 形容 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求が正常に完了しました。 |
必要条件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |
関連項目
dereferenceSwitchPortの
NdisFOidRequestの
ReferenceSwitchPortの