FltCreateCommunicationPort 関数 (fltkernel.h)

[アーティクル]
07/16/2024

FltCreateCommunicationPort は、ミニフィルターがユーザーモードのアプリケーションとサービスからの接続要求を受信できる通信サーバーポートを作成します。

構文

NTSTATUS FLTAPI FltCreateCommunicationPort(
  PFLT_FILTER            Filter,
  PFLT_PORT              *ServerPort,
  POBJECT_ATTRIBUTES     ObjectAttributes,
  PVOID                  ServerPortCookie,
  PFLT_CONNECT_NOTIFY    ConnectNotifyCallback,
  PFLT_DISCONNECT_NOTIFY DisconnectNotifyCallback,
  PFLT_MESSAGE_NOTIFY    MessageNotifyCallback,
  LONG                   MaxConnections
);

パラメーター

Filter

[in]呼び出し元の不透明なフィルターポインター。

ServerPort

[out]通信サーバーポートの不透明なポートハンドルを受け取る呼び出し元によって割り当てられた変数へのポインター。ミニフィルターは、このハンドルを使用して、ユーザーモードアプリケーションからの着信接続要求をリッスンします。

ObjectAttributes

[in]通信サーバーポートの属性を指定する OBJECT_ATTRIBUTES 構造体へのポインター。この構造体は、InitializeObjectAttributes以前の呼び出しによって初期化されている必要があります。このパラメーターは必須であり、NULL にすることはできません。通信ポートオブジェクトのこの構造体のメンバーは、次のとおりです。

メンバー	価値
の長さの	InitializeObjectAttributes このメンバーを `sizeof(OBJECT_ATTRIBUTES)`に設定します。
ObjectName	ポートオブジェクトの一意の名前 (L"\MyFilterPort"など) を含む UNICODE_STRING 構造体へのポインター。
SecurityDescriptor	ポートオブジェクトに適用するセキュリティ記述子 (SECURITY_DESCRIPTOR) へのポインター。必要に応じて、FltBuildDefaultSecurityDescriptor呼び出すことによって、既定のセキュリティ記述子を作成できます。
属性の	ポートハンドルに必要な属性を指定するフラグのビットマスク。これらのフラグには、OBJ_KERNEL_HANDLEを含める必要があります。呼び出し元は必要に応じて、OBJ_CASE_INSENSITIVE フラグを設定することもできます。これは、完全一致検索を実行するのではなく、名前参照コード ObjectName の大文字と小文字を無視する必要があることを示します。

ServerPortCookie

[入力、省略可能]ミニフィルターによって定義されたコンテキスト情報へのポインター。この情報を使用して、同じミニフィルターによって作成された複数の通信サーバーポートを区別できます。 FltMgr は、このコンテキストポインターをパラメーターとして ConnectNotifyCallback ルーチンに渡します。このパラメーターは省略可能であり、NULL にすることができます。

ConnectNotifyCallback

[in]ConnectNotifyCallback コールバックルーチン呼び出し元が指定したポインター。 FltMgr は、ユーザーモードアプリケーションが FilterConnectCommunicationPort を呼び出して接続要求をミニフィルターに送信たびに、このルーチンを呼び出します。このパラメーターは必須であり、NULL にすることはできません。

DisconnectNotifyCallback

[in]呼び出し元が指定した DisconnectNotifyCallback コールバックルーチンへのポインター。 FltMgr 、クライアントポートのユーザーモードハンドル数が 0 に達したとき、またはミニフィルターがアンロードされるときに、このルーチンを呼び出します。このパラメーターは必須であり、NULL にすることはできません。

MessageNotifyCallback

[入力、省略可能]MessageNotifyCallback コールバックルーチン呼び出し元から提供されるポインター。 FltMgr 、ユーザーモードアプリケーションが FilterSendMessage を呼び出して、クライアントポートを介してミニフィルターにメッセージを送信するたびに、このルーチンを呼び出します。このパラメーターは省略可能であり、NULL にすることができます。 NULL の場合、ポートにデータを送信するためにユーザーモードから行われた要求はエラーを受け取ります。

MaxConnections

[in]このサーバーポートで許可される同時クライアント接続の最大数。このパラメーターは必須であり、0 より大きい必要があります。

戻り値

FltCreateCommunicationPort は、STATUS_SUCCESSまたは次のいずれかの適切な NTSTATUS 値を返します。

リターンコード	形容
STATUS_FLT_DELETING_OBJECT	指定したフィルターが取り壊されています。これはエラーコードです。
STATUS_INSUFFICIENT_RESOURCES	FltCreateCommunicationPort プール割り当てエラーが発生。これはエラーコードです。
STATUS_OBJECT_NAME_COLLISION	同じ名前のミニフィルター通信ポートが既に存在します。ポート名は一意である必要があります。これはエラーコードです。

備考

ミニフィルター FltCreateCommunicationPort を呼び出して、通信サーバーポートオブジェクトを作成します。

サーバーポートが作成されたら、ユーザーモードアプリケーションは、FilterConnectCommunicationPortを呼び出すことによってポートに接続できます。接続されている場合、ユーザーモードアプリケーションは、FilterSendMessage、FilterGetMessage、FilterReplyMessageなどのユーザーモードメッセージング機能を呼び出すことによってメッセージを送受信できます。

呼び出し元は、FltCreateCommunicationPortの ObjectAttributes パラメーターに OBJ_KERNEL_HANDLE Attributes フラグ設定する必要があります。このフラグを設定すると、FltCreateCommunicationPort の呼び出し元のコンテキストが実行されている可能性があるユーザーモードプロセスでミニフィルター通信サーバーポートハンドルが使用されなくなります。このフラグが設定されていない場合、FltCreateCommunicationPort はSTATUS_INVALID_PARAMETERを返します。

FltCreateCommunicationPort を作成サーバーポートは、最終的に FltCloseCommunicationPort呼び出すことによって閉じる必要があります。サーバーポートを閉じると、サーバーポートへの新しい接続は許可されず、FilterConnectCommunicationPort へのすべての呼び出しは失敗します。ただし、既存の接続は、ユーザーモードアプリケーションまたはミニフィルターによって閉じられるまで、またはミニフィルターがアンロードされるまで開いたままです。

詳細については、「ユーザーモードとミニフィルターの間の通信を参照してください。

必要条件

要件	価値
ターゲットプラットフォームの	万国
ヘッダー	fltkernel.h (Fltkernel.h を含む)
ライブラリ	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

次の方法で共有

FltCreateCommunicationPort 関数 (fltkernel.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース