PFLT_CONNECT_NOTIFY Rückruffunktion (fltkernel.h)

Artikel
07/16/2024

FltMgr ruft die ConnectNotifyCallback- Rückruffunktion eines Minifilters auf, um den Minifilter zu benachrichtigen, wenn eine neue Verbindung mit einem Kommunikationsport angefordert wird.

Syntax

PFLT_CONNECT_NOTIFY PfltConnectNotify;

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

Parameter

ClientPort

[in] Opaque, FltMgr-generiert handle für den neuen Clientport, der zwischen der Benutzermodusanwendung und dem Kernelmodus-Minifilter eingerichtet wird.

Der Minifilter muss dieses Handle als ClientPort Parameter an FltSendMessage übergeben, wenn Nachrichten an diesen Clientport gesendet und beantwortet werden.

Der Minifilter muss schließlich FltCloseClientPort aufrufen, um diesen Clientport zu schließen, in der Regel aus seiner DisconnectNotifyCallback- Routine.

ClientPort- ist nicht mit dem ServerPort Handle return byFltCreateCommunicationPortidentisch.

ServerPortCookie

[in] Zeiger auf Kontextinformationen, die vom Minifilter definiert werden. Der Minifilter kann diese Informationen verwenden, um zwischen mehreren Kommunikationsserverports zu unterscheiden, die möglicherweise erstellt werden. Beim Erstellen des Serverports hat der Minifiltertreiber diesen Kontextzeiger als ServerPortCookie Parameter an FltCreateCommunicationPortübergeben.

ConnectionContext

[in] Kontextinformationspunkt, den die Benutzermodusanwendung im lpContext Parameter an FilterConnectCommunicationPortübergeben hat.

SizeOfContext

[in] Größe des Puffers, auf den ConnectionContext verweist, in Byte.

ConnectionPortCookie

[out] Zeigen Sie auf die Informationen des Miniports, die diesen Clientport eindeutig identifiziert. Der Minifilter kann dieses Cookie verwenden, um die Verbindung zu identifizieren, wenn FltMgr sie in nachfolgenden Aufrufen an MessageNotifyCallback und DisconnectNotifyCallbackübergibt.

Rückgabewert

ConnectNotifyCallback- gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist und die Verbindung akzeptiert wurde. Andernfalls wird ein entsprechender NTSTATUS-Wert zurückgegeben, z. B.:

Rückgabecode	Bedeutung
STATUS_INSUFFICIENT_RESOURCES	Es gibt nicht genügend Ressourcen, um den Vorgang abzuschließen.
STATUS_INVALID_PARAMETER	Mindestens ein Eingabeparameter ist ungültig.

Bemerkungen

FltMgr diese Routine aufruft, wenn eine Anwendung im Benutzermodus FilterConnectCommunicationPort aufruft, um eine Verbindungsanforderung an den Minifiltertreiber zu senden.

Der Minifilter sollte alle erforderlichen Überprüfungen des Verbindungsversuchs ausführen.

Weitere Informationen finden Sie unter Kommunikation zwischen Benutzermodus und Minifiltern.