NdisFGetOptionalSwitchHandlers 関数 (ndis.h)

Hyper-V 拡張可能スイッチ拡張機能は 、NdisFGetOptionalSwitchHandlers 関数を呼び出して、Hyper-V 拡張可能スイッチ ハンドラー関数へのポインターの一覧を取得します。

構文

NDIS_STATUS NdisFGetOptionalSwitchHandlers(
  [in]      NDIS_HANDLE                    NdisFilterHandle,
  [out]     PNDIS_SWITCH_CONTEXT           NdisSwitchContext,
  [in, out] PNDIS_SWITCH_OPTIONAL_HANDLERS NdisSwitchHandlers
);

パラメーター

[in] NdisFilterHandle

このフィルター モジュールを識別する NDIS ハンドル。 NDIS は、拡張機能の FilterAttach 関数を呼び出すと、 NdisFilterHandle パラメーターでこのハンドルを渡しました。

[out] NdisSwitchContext

拡張機能がアタッチされている拡張可能スイッチ モジュールを識別するNDIS_SWITCH_CONTEXT値へのポインター。 拡張機能が拡張可能スイッチ ハンドラー関数を呼び出す場合は、 NdisSwitchContext パラメーターをこのハンドルの値に設定する必要があります。

[in, out] NdisSwitchHandlers

呼び出し元によって割り当てられた NDIS_SWITCH_OPTIONAL_HANDLERS 構造体へのポインター。 呼び出しが成功した場合、この構造体には拡張可能スイッチ ハンドラー関数へのポインターの一覧が含まれます。

これらのハンドラー関数の詳細については、「 Hyper-V 拡張可能スイッチ ハンドラー関数」を参照してください。

戻り値

呼び出しが成功した場合、 NdisFGetOptionalSwitchHandlers は NDIS_STATUS_SUCCESSを返します。 それ以外の場合は、拡張可能スイッチ拡張機能が基になる拡張可能スイッチ コンポーネントにバインドされていない場合は、NDIS_STATUS_NOT_SUPPORTEDを返します。

注釈

この拡張機能は、FilterAttach 関数から NdisFGetOptionalSwitchHandlers 関数を呼び出します。

拡張機能が複数の FilterMediaTypes INF エントリと共にインストールされている場合、 NdisFGetOptionalSwitchHandlers の呼び出しにより、拡張機能は拡張スイッチまたは物理ネットワーク アダプターのドライバー スタックにバインドされ、接続されているかどうかを判断できます。 呼び出しがNDIS_STATUS_SUCCESSを返す場合、拡張機能は拡張可能スイッチ ドライバー スタック内にアタッチされます。 呼び出しから NDIS_STATUS_NOT_SUPPORTEDが返された場合、拡張機能は物理ネットワーク アダプターのドライバー スタック内に接続されます。

拡張可能スイッチ拡張機能の FilterMediaTypes INF エントリの詳細については、「 HYPER-V 拡張可能スイッチ拡張機能の INF 要件」を参照してください。

要件

こちらもご覧ください

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS