Функция FltCloseClientPort (fltkernel.h)

FltCloseClientPort закрывает порт клиента связи.

Синтаксис

VOID FLTAPI FltCloseClientPort(
  [in]  PFLT_FILTER Filter,
  [out] PFLT_PORT   *ClientPort
);

Параметры

[in] Filter

Указатель непрозрачного фильтра для вызывающего объекта. Этот параметр является обязательным и не может иметь значение NULL.

[out] ClientPort

Указатель на переменную, содержащую дескриптор непрозрачного порта для закрываемого клиентского порта. При возврате переменная получает значение NULL. Этот параметр является обязательным и не может иметь значение NULL на входных данных.

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

None

Remarks

Драйвер мини-фильтра обычно вызывает FltCloseClientPort из подпрограммы DisconnectNotifyCallback , зарегистрированной при вызове FltCreateCommunicationPort. Диспетчер фильтров вызывает подпрограмму DisconnectNotifyCallback всякий раз, когда число дескрипторов пользовательского режима для порта клиента достигает нуля или когда драйвер мини-фильтра будет выгружен.

FltCloseClientPort закрывает порт клиента связи, созданный процедурой ConnectNotifyCallback драйвера мини-фильтра.

При входных данных параметр ClientPort является указателем на переменную, содержащую непрозрачный дескриптор для закрываемого порта клиента. Чтобы убедиться, что все сообщения, отправляемые FltSendMessage, правильно синхронизированы при закрытии порта клиента связи, FltCloseClientPort устанавливает для этой переменной значение NULL.

Эта процедура отключает определенное подключение от драйвера мини-фильтра. Чтобы закрыть дескриптор для порта сервера драйвера минифильтра, который прослушивает входящие подключения, используйте FltCloseCommunicationPort.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая Fltkernel.h)
Библиотека	Fltmgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

См. также раздел

FilterConnectCommunicationPort

FltCloseCommunicationPort

FltCreateCommunicationPort

FltSendMessage