次の方法で共有

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_SWITCH_OPTIONAL_HANDLERS 構造体の Header メンバーを初期化する必要があります。
 

戻り値

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

備考

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

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

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

必要条件

要件 価値
サポートされる最小クライアント NDIS 6.30 以降でサポートされています。
ターゲット プラットフォーム の 万国
ヘッダー ndis.h (Ndis.h を含む)
ライブラリ Ndis.lib
IRQL <= DISPATCH_LEVEL

関連項目

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS