FilterConnectCommunicationPort 関数 (fltuser.h)
FilterConnectCommunicationPort は、ファイル システム ミニフィルターによって作成された通信サーバー ポートへの新しい接続を開きます。
構文
HRESULT FilterConnectCommunicationPort(
[in] LPCWSTR lpPortName,
[in] DWORD dwOptions,
[in, optional] LPCVOID lpContext,
[in] WORD wSizeOfContext,
[in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
[out] HANDLE *hPort
);
パラメーター
[in] lpPortName
通信サーバー ポートの完全修飾名 (例: L"\MyFilterPort") を含む NULL で終わるワイド文字文字列へのポインター。
[in] dwOptions
通信ポートの接続オプション。 Windows 8.1 より前では、この値は 0 に設定されています。
| 価値 | 意味 |
|---|---|
|
hPort で返されるハンドルは、同期 I/O 用です。 このフラグは、Windows 8.1 以降で使用できます。 |
[in, optional] lpContext
カーネル モード ミニフィルターの接続通知ルーチンに渡される呼び出し元が指定したコンテキスト情報へのポインター。 (
[in] wSizeOfContext
lpContext パラメーターが指す構造体のサイズ (バイト単位)。
[in, optional] lpSecurityAttributes
返されたハンドルを子プロセスによって継承できるかどうかを決定するSECURITY_ATTRIBUTES構造体へのポインター。 SECURITY_ATTRIBUTES構造の詳細については、Microsoft Windows SDK のドキュメントを参照してください。 このパラメーターは省略可能であり、NULL
[out] hPort
FilterConnectCommunicationPort の呼び出しが成功した場合に、新しく作成された接続ポートのハンドルを受け取る呼び出し元によって割り当てられた変数へのポインター。それ以外の場合は、INVALID_HANDLE_VALUEを受け取ります。
戻り値
FilterConnectCommunicationPort
備考
FilterConnectCommunicationPort は、ユーザー モード アプリケーションに代わってミニフィルターの通信サーバー ポートへの接続を開きます。 アプリケーションは、結果の接続ポート ハンドルを使用してミニフィルターと通信します。
FilterConnectCommunicationPort
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
万国 |
| ヘッダー | fltuser.h (Fltuser.h を含む) |
| ライブラリ | FltLib.lib |
| DLL | FltLib.dll |
関連項目
CloseHandle の
FltBuildDefaultSecurityDescriptor の
FltCloseClientPort の
FltCloseCommunicationPort を
FltCreateCommunicationPort を
FltFreeSecurityDescriptor の