NdisFRegisterFilterDriver 関数 (ndis.h)

[アーティクル]
02/29/2024

フィルタードライバーは、を呼び出します。FilterXxx 関数を NDIS に登録する NdisFRegisterFilterDriver 関数。

構文

NDIS_STATUS NdisFRegisterFilterDriver(
  [in]  PDRIVER_OBJECT                      DriverObject,
  [in]  NDIS_HANDLE                         FilterDriverContext,
        PNDIS_FILTER_DRIVER_CHARACTERISTICS FilterDriverCharacteristics,
  [out] PNDIS_HANDLE                        NdisFilterDriverHandle
);

パラメーター

[in] DriverObject

フィルタードライバーが Argument1 パラメーターで DriverEntry ルーチンで受け取った不透明なドライバーオブジェクトへのポインター。 (詳細については、「 NDIS フィルタードライバーの DriverEntry」を参照してください)。

[in] FilterDriverContext

ドライバーが状態と構成情報を保持する、ドライバーによって割り当てられたコンテキスト領域へのハンドル。

FilterDriverCharacteristics

へのポインター NDIS_FILTER_DRIVER_CHARACTERISTICSFilterXxx 関数エントリポイントを使用してフィルタードライバーが作成および初期化した構造体です。

[out] NdisFilterDriverHandle

ハンドル変数へのポインター。の呼び出し NdisFRegisterFilterDriver は成功し、NDIS はこの変数にフィルタードライバーハンドルを入力します。フィルタードライバーは、このハンドルを保存し、後で入力パラメーターとしてフィルタードライバーハンドルを必要とする NDIS 関数 ( NdisFDeregisterFilterDriver など) にこのハンドルを渡します。

戻り値

NdisFRegisterFilterDriver は 、次のいずれかの状態値を返します。

リターンコード	説明
NDIS_STATUS_SUCCESS	NdisFRegisterFilterDriver は、フィルタードライバーを登録した場合にNDIS_STATUS_SUCCESSを返します。
NDIS_STATUS_BAD_VERSION	FilterCharacteristics で構造体の MajorNdisVersion メンバーで指定されているバージョンが無効です。
NDIS_STATUS_BAD_CHARACTERISTICS	で指定されているメンバーの少なくとも 1 つ NDIS_FILTER_DRIVER_CHARACTERISTICS が無効です。
NDIS_STATUS_INVALID_PARAMETER	ドライバーが渡した入力パラメーターの少なくとも 1 つ NdisFRegisterFilterDriver が無効です。
NDIS_STATUS_RESOURCES	リソースが不足しているため、NdisFRegisterFilterDriver が失敗しました。
NDIS_STATUS_FAILURE	NdisFRegisterFilterDriver は、上記の値が適用されない場合にNDIS_STATUS_FAILUREを返します。

注釈

フィルタードライバーは、を呼び出します。DriverEntry ルーチンからの NdisFRegisterFilterDriver 関数。 DriverEntry の詳細については、「NDIS フィルタードライバーの DriverEntry」を参照してください。

NdisFRegisterFilterDriver を呼び出すドライバーは、FilterXxx 関数のいずれかをすぐに呼び出すために準備する必要があります。詳細については、「フィルタードライバーの初期化」を参照してください。

すべてのフィルタードライバーは、を設定して FilterXxx 関数のセットをエクスポートします。 NDIS_FILTER_DRIVER_CHARACTERISTICS 構造体と呼び出し NdisFRegisterFilterDriver。 NDIS は、この構造体を NDIS ライブラリの内部記憶域にコピーします。

フィルタードライバーがオプションのサービスを登録できるようにするには、のコンテキスト内で FilterSetOptions 関数を呼び出します。 NdisFRegisterFilterDriver。

登録後、フィルタードライバーは後で NdisSetOptionalHandlers 関数を呼び出して、オプションの FilterXxx 関数のエントリポイントを変更できます。

フィルタードライバーは、を呼び出します。以前にで割り当てられたリソースを解放する NdisFDeregisterFilterDriver 関数 NdisFRegisterFilterDriver。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	デスクトップ
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	Irql_Filter_Driver_Function(ndis)、 NdisFDeregisterFilterDriver(ndis)