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

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

構文

NDIS_SWITCH_REFERENCE_SWITCH_NIC NdisSwitchReferenceSwitchNic;

NDIS_STATUS NdisSwitchReferenceSwitchNic(
  [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 エラー コードを返します。

注釈

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

拡張機能は ReferenceSwitchNic を呼び出した後、 DereferenceSwitchNic を呼び出して拡張可能スイッチ参照カウンターをデクリメントする必要があります。

拡張機能は、次の操作を実行する前に ReferenceSwitchNic を呼び出す必要があります。

• 拡張可能スイッチ制御パスを介して 、OID_SWITCH_NIC_REQUEST OID 要求を基になる物理ネットワーク アダプターに転送します。

  詳細については、「 物理ネットワーク アダプターへの OID 要求の管理」を参照してください。

• 基になる外部アダプターから拡張可能スイッチ制御パスに NDIS_STATUS_SWITCH_NIC_STATUS状態表示 を転送します。

  詳細については、「 物理ネットワーク アダプターからの NDIS 状態表示の管理」を参照してください。

要件

こちらもご覧ください

DereferenceSwitchNic

NDIS_STATUS_SWITCH_NIC_STATUS

NdisFGetOptionalSwitchHandlers

OID_SWITCH_NIC_DELETE

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_NIC_REQUEST