NDIS_SWITCH_DEREFERENCE_SWITCH_NICコールバック関数 (ndis.h)

DereferenceSwitchNic 関数は、拡張可能スイッチ ポートに接続されているネットワーク アダプターの Hyper-V 拡張可能スイッチ参照カウンターをデクリメントします。 ReferenceSwitchNic の以前の呼び出しによって 、参照カウンターがインクリメントされました。

構文

NDIS_SWITCH_DEREFERENCE_SWITCH_NIC NdisSwitchDereferenceSwitchNic;

NDIS_STATUS NdisSwitchDereferenceSwitchNic(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId,
  [in] NDIS_SWITCH_NIC_INDEX SwitchNicIndex
)
{...}

パラメーター

[in] NdisSwitchContext

Hyper-V 拡張可能スイッチ拡張機能がアタッチされている拡張可能スイッチ モジュールのハンドルを含むNDIS_SWITCH_CONTEXT値。 拡張機能が NdisFGetOptionalSwitchHandlers を呼び出すと、このハンドルは NdisSwitchContext パラメーターを介して返されます。

[in] SwitchPortId

仮想ネットワーク アダプターが接続されている拡張可能スイッチ ポートの一意識別子を含むNDIS_SWITCH_PORT_ID値。

[in] SwitchNicIndex

拡張可能スイッチ参照カウンターをインクリメントする仮想ネットワーク アダプターのインデックスを指定するNDIS_SWITCH_NIC_INDEX値。

NDIS_SWITCH_NIC_INDEX値の詳細については、「 ネットワーク アダプターのインデックス値」を参照してください。

戻り値

呼び出しが成功した場合、関数はNDIS_STATUS_SUCCESSを返します。 それ以外の場合は、Ndis.h で定義されているNDIS_STATUS_Xxx エラー コードが返されます。

注釈

拡張可能スイッチ拡張機能は 、DereferenceSwitchNic を呼び出して、拡張可能スイッチ ポートに接続されているネットワーク アダプターの参照カウンターをデクリメントします。 拡張可能スイッチ参照カウンターには 0 以外の値が設定されていますが、拡張可能スイッチのプロトコル エッジは、アダプターへの接続を削除するために 、OID_SWITCH_NIC_DELETE のオブジェクト識別子 (OID) セット要求を発行しません。

ネットワーク アダプター接続に対して ReferenceSwitchNic が以前に呼び出されていた場合、拡張機能は DereferenceSwitchNic を呼び出す必要があります。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.30 以降でサポートされています。
対象プラットフォーム	デスクトップ
Header	ndis.h (Ndis.h を含む)
IRQL	<= DISPATCH_LEVEL

こちらもご覧ください

NdisFGetOptionalSwitchHandlers

OID_SWITCH_NIC_DELETE

ReferenceSwitchNic