FltCloseClientPort function

FltCloseClientPort closes a communication client port.

Syntax


VOID FltCloseClientPort(
  _In_  PFLT_FILTER Filter,
  _Out_ PFLT_PORT   *ClientPort
);

Parameters

Filter [in]

Opaque filter pointer for the caller. This parameter is required and cannot be NULL.

ClientPort [out]

Pointer to a variable that contains the opaque port handle for the client port to be closed. On return, the variable receives NULL. This parameter is required and cannot be NULL on input.

Return value

None

Remarks

A minifilter driver normally calls FltCloseClientPort from the DisconnectNotifyCallback routine that it registered when it called FltCreateCommunicationPort. The Filter Manager calls the DisconnectNotifyCallback routine whenever the user-mode handle count for the client port reaches zero or when the minifilter driver is about to be unloaded.

FltCloseClientPort closes a communication client port that was created by the minifilter driver's ConnectNotifyCallback routine.

On input, the ClientPort parameter is a pointer to a variable containing the opaque handle for the client port to be closed. To ensure that any messages sent by FltSendMessage are synchronized properly when the communication client port is being closed, FltCloseClientPort sets this variable to NULL.

This routine disconnects a specific connection from the minifilter driver. To close the handle for the minifilter driver's server port, which listens for incoming connections, use FltCloseCommunicationPort.

Requirements

Target platform

Universal

Header

Fltkernel.h (include Fltkernel.h)

Library

Fltmgr.lib

DLL

Fltmgr.sys

IRQL

PASSIVE_LEVEL

See also

FilterConnectCommunicationPort
FltCloseCommunicationPort
FltCreateCommunicationPort
FltSendMessage

 

 

Send comments about this topic to Microsoft

Show: