Функция FilterConnectCommunicationPort (fltuser.h)

Статья
11/20/2024

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

Указатель на строку, завершающуюся значением NULL, содержащую полное имя порта сервера коммуникации (например, L"\MyFilterPort").

[in] dwOptions

Параметры подключения для порта связи. До Windows 8.1 это значение равно 0.

Ценность	Значение
FLT_PORT_FLAG_SYNC_HANDLE	Дескриптор, возвращаемый в hPort, предназначен для синхронного ввода-вывода. Этот флаг доступен начиная с Windows 8.1.

[in, optional] lpContext

Указатель на сведения о контексте, предоставленные вызывающим объектом, которые передаются в подпрограмму уведомлений в режиме ядра. (См. параметр connectNotifyCallback в справочной странице для FltCreateCommunicationPort.) Этот параметр является необязательным и может быть null.

[in] wSizeOfContext

Размер в байтах структуры, на которую указывает параметр lpCon text. Если значение lpContext не являетсяNULL, этот параметр должен быть ненулевой. Если lpContextNULL, этот параметр должен быть равен нулю.

[in, optional] lpSecurityAttributes

Указатель на структуру SECURITY_ATTRIBUTES, которая определяет, может ли возвращаемый дескриптор наследоваться дочерними процессами. Дополнительные сведения о структуре SECURITY_ATTRIBUTES см. в документации по пакету SDK для Microsoft Windows. Этот параметр является необязательным и может быть null. Если этот параметр null, то дескриптор не может быть унаследован.

[out] hPort

Указатель на выделенную вызывающим переменную, которая получает дескриптор для только что созданного порта подключения, если вызов FilterConnectCommunicationPort успешно; в противном случае он получает INVALID_HANDLE_VALUE.

Возвращаемое значение

FilterConnectCommunicationPort возвращает S_OK в случае успешного выполнения. В противном случае возвращается значение ошибки.

Замечания

FilterConnectCommunicationPort открывает подключение к порту сервера связи мини-фильтра от имени приложения в пользовательском режиме. Приложение использует результирующий дескриптор порта подключения для взаимодействия с минифильтром.

После успешного вызова FilterConnectCommunicationPortприложение может отправлять сообщения в мини-фильтр через порт подключения путем вызова FilterSendMessage. Он также может получать и отвечать на сообщения от минифильтра путем вызова FilterGetMessage и FilterReplyMessageсоответственно. Дескриптор порта подключения, возвращенный в параметре hPort , передается в качестве первого параметра FilterSendMessage, FilterGetMessageи FilterReplyMessage.

Любой дескриптор, полученный из FilterConnectCommunicationPort, должен быть освобожден путем вызова CloseHandle.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	fltuser.h (include Fltuser.h)
библиотеки	FltLib.lib
DLL	FltLib.dll