PFLT_CONNECT_NOTIFY callback function (fltkernel.h)

FltMgr calls a minifilter's ConnectNotifyCallback callback function to notify the minifilter when a new connection to a communication port is being requested.

Syntax

PFLT_CONNECT_NOTIFY PfltConnectNotify;

NTSTATUS PfltConnectNotify(
  PFLT_PORT ClientPort,
  PVOID ServerPortCookie,
  PVOID ConnectionContext,
  ULONG SizeOfContext,
  PVOID *ConnectionPortCookie
)
{...}

Parameters

ClientPort

[in] Opaque, FltMgr-generated handle for the new client port that is being established between the user-mode application and the kernel-mode minifilter.

The minifilter must pass this handle as the ClientPort parameter to FltSendMessage when sending and replying to messages on this client port.

The minifilter must eventually call FltCloseClientPort to close this client port, typically from its DisconnectNotifyCallback routine.

ClientPort isn't the same as the ServerPort handle return byFltCreateCommunicationPort.

ServerPortCookie

[in] Pointer to context information defined by the minifilter. The minifilter can use this information to distinguish among multiple communication server ports that it might create. When the server port was created, the minifilter driver passed this context pointer as the ServerPortCookie parameter to FltCreateCommunicationPort.

ConnectionContext

[in] Context information pointer that the user-mode application passed in the lpContext parameter to FilterConnectCommunicationPort.

SizeOfContext

[in] Size, in bytes, of the buffer that ConnectionContext points to.

ConnectionPortCookie

[out] Pointer to the miniport's information that uniquely identifies this client port. The minifilter can use this cookie to identify the connection when FltMgr passes it in subsequent calls to MessageNotifyCallback and DisconnectNotifyCallback.

Return value

ConnectNotifyCallback returns STATUS_SUCCESS if the operation succeeds and the connection has been accepted. Otherwise, it returns an appropriate NTSTATUS value such as:

Remarks

FltMgr calls this routine whenever a user-mode application calls FilterConnectCommunicationPort to send a connection request to the minifilter driver.

The minifilter should perform any necessary validation of the connection attempt.

For more information, see Communication between user-mode and minifilters.

Requirements

See also

FilterConnectCommunicationPort

FltCloseClientPort

FltCreateCommunicationPort

FltSendMessage

DisconnectNotifyCallback

MessageNotifyCallback