OID_SWITCH_NIC_DELETE

  • [アーティクル]

Hyper-V 拡張可能スイッチのプロトコル エッジは、拡張可能スイッチ ドライバー スタックに OID_SWITCH_NIC_DELETE のオブジェクト識別子 (OID) セット要求を発行します。 この OID 要求は、拡張可能スイッチ ポートとネットワーク アダプター間の接続の削除について、下位拡張可能スイッチ拡張機能に通知します。 拡張可能スイッチのプロトコル エッジは、 OID_SWITCH_NIC_DISCONNECT の OID セット要求を発行したときに、この接続が削除されていることを拡張機能に以前に通知しました。

NDIS_SWITCH_NIC_PARAMETERS 構造体の InformationBuffer メンバーには、 NDIS_NIC_SWITCH_PARAMETERS 構造体を指すポインターが含まれています。

解説

NDIS_SWITCH_NIC_PARAMETERS 構造体の PortId sメンバーは、削除通知を行う拡張可能スイッチ ポートを指定します。 拡張可能スイッチ拡張機能は、 OID_SWITCH_PORT_ARRAY の OID クエリ要求を発行することで、拡張可能スイッチのこれと他のポートのパラメーター情報を取得できます。

NDIS_SWITCH_NIC_PARAMETERS 構造体の Index メンバーが、削除続通知の行われているネットワーク アダプターのインデックスを指定します。 指定された Index 値を持つネットワーク アダプターは、 PortId メンバーによって指定された拡張可能スイッチ ポートに接続されます。 これらのインデックス値の詳細については、 ネットワーク アダプターのインデックス値 を参照してください。

拡張可能スイッチのプロトコル エッジが OID_SWITCH_NIC_DELETE 要求を発行する前に、指定されたネットワーク アダプター接続に対するすべての保留中の送受信パケット要求が完了していることを保証します。 また、プロトコル エッジでは、アダプター接続に対するすべての保留中の OID 要求が完了していること、およびアダプター接続の拡張可能スイッチ参照カウンターの値が 0 であることを保証します。

注:ReferenceSwitchNic を呼び出すことによって、拡張機能がネットワーク アダプターの拡張可能スイッチ参照カウンターをインクリメントした場合、OID_SWITCH_NIC_DELET E要求は発行されませんが、参照カウンターは 0 以外です。 この拡張機能は、 DereferenceSwitchNic を呼び出すことによって、拡張可能スイッチ参照カウンターをデクリメントします。

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

  • 拡張機能は、OID 要求に関連付けられている NDIS_SWITCH_NIC_PARAMETERS 構造体を変更することはできません。

  • 拡張機能は、この OID セット要求を下位拡張機能に常に転送する必要があります。 拡張機能は要求を完了してはなりません。

  • 注 拡張機能は、OID_SWITCH_NIC_DELETE の独自の OID セット要求を発行することはできません。

  • 拡張可能スイッチ外部ネットワーク アダプターは、1つ以上の下位物理アダプターにバインドできます。 外部ネットワーク アダプターにバインドされているすべての物理ネットワーク アダプターについて、拡張可能スイッチのプロトコル エッジは、 OID_SWITCH_NIC_DELETE の個別 OID 設定要求を発行します。 各 OID セット要求は、異なるネットワーク アダプター接続インデックス値を指定します。 これらのインデックス値の詳細については、 ネットワーク アダプターのインデックス値 を参照してください。

    拡張機能は、各下位物理アダプターの接続状態を保持する必要があります。 物理ネットワーク アダプターを外部ネットワーク アダプターにバインドできるさまざまな構成の詳細については、 物理ネットワーク アダプター構成の種類 を参照してください。

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

状態コードを返します

拡張可能スイッチの下位ミニポート エッジは、OID_SWITCH_NIC_DELETE の OID クエリ要求を完了し、次のいずれかの状態コードを返します。

状態コード 説明

NDIS_STATUS_SUCCESS

OID 要求は正常に完了しました。

要件

バージョン

NDIS 6.30 以降でサポートされています。

ヘッダー

 Ntddndis.h (Ndis.h を含む)

関連項目

DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_PORT_ARRAY

ReferenceSwitchNic