OID_SWITCH_PORT_DELETE

Hyper-V 拡張可能スイッチのプロトコルエッジは、拡張可能スイッチポートの削除について拡張可能スイッチ拡張機能に通知するために、OID_SWITCH_PORT_DELETEのオブジェクト識別子 (OID) セット要求を発行します。

NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_SWITCH_PORT_PARAMETERS 構造体へのポインターが含まれています。

備考

NDIS_SWITCH_PORT_PARAMETERS 構造体の PortId メンバーは、削除通知を行う拡張可能スイッチポートを指定します。

ネットワークアダプターが指定されたポートに接続されている場合、拡張可能スイッチのプロトコルエッジは、ポートを削除する前に接続を削除します。この場合、プロトコルエッジはポートを削除する前に次の手順に従います。

プロトコルエッジは、ネットワークアダプターと拡張可能スイッチポート間の接続が削除されていることを拡張機能に通知するために、OID_SWITCH_NIC_DISCONNECT の OID セット要求を発行します。
指定した拡張可能スイッチポートのすべての保留中のパケットが取り消されるか完了すると、プロトコルエッジは、ネットワークアダプターと拡張可能スイッチポート間の接続が削除されたことを拡張機能に通知するために、OID_SWITCH_NIC_DELETE の OID セット要求を発行します。

この時点で、プロトコルエッジはポートの削除を開始できます。

拡張可能スイッチのプロトコルエッジは、拡張可能スイッチポートを削除するときに、次の手順に従います。

拡張可能スイッチのプロトコルエッジは、OID_SWITCH_PORT_TEARDOWNの OID セット要求を発行します。この OID 要求は、拡張可能スイッチポートの削除プロセスの開始について、基になる拡張可能スイッチ拡張機能に通知します。
プロトコルエッジは、拡張可能スイッチポートへのすべての OID 要求が完了した後、OID_SWITCH_PORT_DELETEの OID セット要求を発行します。

注以前に拡張機能がポートの参照カウンターをインクリメントするために ReferenceSwitchPort を呼び出した場合、プロトコルエッジが OID_SWITCH_NIC_DELETE 要求を発行する前に、DereferenceSwitchPort を呼び出す必要があります。

拡張機能は、OID_SWITCH_PORT_DELETEの OID セット要求を処理するために、次のガイドラインに従う必要があります。

拡張機能は、OID 要求に関連付けられている NDIS_SWITCH_PORT_PARAMETERS 構造体を変更することはできません。
拡張機能は、この OID セット要求を基になる拡張機能に常に転送する必要があります。拡張機能は要求を失敗してはなりません。
OID_SWITCH_PORT_DELETE要求が NDIS_STATUS_SUCCESS で完了すると、拡張機能は削除されたポートのパケットや OID 要求を受信しません。拡張機能は、削除されたポートにパケットを転送できません。また、拡張機能は、OID 要求を発行したり、削除されたポートの ReferenceSwitchPort 関数を呼び出したりすることもできません。

拡張可能スイッチ拡張機能、OID_SWITCH_PORT_DELETEの OID セット要求を発行してはならないことに注意してください。

拡張可能スイッチポートとネットワークアダプター接続の状態の詳細については、「Hyper-V 拡張可能スイッチポートとネットワークアダプターの状態を参照してください。

拡張可能スイッチの基になるミニポートエッジは、OID_SWITCH_PORT_DELETEの OID セット要求を完了し、次の状態コードを返します。

状態コード	形容
NDIS_STATUS_SUCCESS	OID 要求が正常に完了しました。

バージョン	NDIS 6.30 以降でサポートされています。
ヘッダ	Ntddndis.h (Ndis.h を含む)