PFLT_CONNECT_NOTIFY funzione di callback (fltkernel.h)

Articolo
07/16/2024

FltMgr chiama il ConnectNotifyCallback di un minifilter funzione di callback per notificare al minifiltro quando viene richiesta una nuova connessione a una porta di comunicazione.

Sintassi

PFLT_CONNECT_NOTIFY PfltConnectNotify;

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

Parametri

ClientPort

[in] Opaco, FltMgrhandle generato per la nuova porta client stabilita tra l'applicazione in modalità utente e il minifiltro in modalità kernel.

Il minifilter deve passare questo handle come parametro ClientPort a FltSendMessage quando si inviano e rispondono ai messaggi sulla porta client.

Il minifiltro deve infine chiamare FltCloseClientPort per chiudere questa porta client, in genere dalla routine DisconnectNotifyCallback.

ClientPort non corrisponde all'handle ServerPort restituito daFltCreateCommunicationPort.

ServerPortCookie

[in] Puntatore alle informazioni di contesto definite dal minifiltro. Il minifiltro può usare queste informazioni per distinguere tra più porte del server di comunicazione che potrebbe creare. Quando è stata creata la porta del server, il driver minifilter ha passato questo puntatore di contesto come parametro ServerPortCookie a FltCreateCommunicationPort.

ConnectionContext

[in] Puntatore alle informazioni di contesto passato dall'applicazione in modalità utente nel parametro lpContext a FilterConnectCommunicationPort.

SizeOfContext

[in] Dimensioni, in byte, del buffer a cui ConnectionContext punta.

ConnectionPortCookie

[out] Puntatore alle informazioni del miniport che identificano in modo univoco questa porta client. Il minifilter può usare questo cookie per identificare la connessione quando FltMgr lo passa nelle chiamate successive a MessageNotifyCallback e DisconnectNotifyCallback.

Valore restituito

ConnectNotifyCallback restituisce STATUS_SUCCESS se l'operazione ha esito positivo e la connessione è stata accettata. In caso contrario, restituisce un valore NTSTATUS appropriato, ad esempio:

Codice restituito	Significato
STATUS_INSUFFICIENT_RESOURCES	Non sono disponibili risorse sufficienti per completare l'operazione.
STATUS_INVALID_PARAMETER	Uno o più parametri di input non sono validi.

Osservazioni

FltMgr chiama questa routine ogni volta che un'applicazione in modalità utente chiama FilterConnectCommunicationPort per inviare una richiesta di connessione al driver minifilter.

Il minifiltro deve eseguire qualsiasi convalida necessaria del tentativo di connessione.

Per altre informazioni, vedere Comunicazione tra la modalità utente e i minifiltri.