FltCloseClientPort, fonction (fltkernel.h)

Article
02/06/2025

FltCloseClientPort ferme un port client de communication.

Syntaxe

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

Paramètres

[in] Filter

Pointeur de filtre opaque pour l’appelant. Ce paramètre est obligatoire et ne peut pas être NULL.

[out] ClientPort

Pointeur vers une variable qui contient le handle de port opaque pour que le port client soit fermé. Lors du retour, la variable reçoit NULL . Ce paramètre est obligatoire et ne peut pas être NULL lors de l’entrée.

Valeur de retour

Aucun

Remarques

Un pilote minifilter appelle normalement FltCloseClientPort à partir de la routine DisconnectNotifyCallback qu’elle a inscrite lorsqu’elle a appelé FltCreateCommunicationPort. Le Gestionnaire de filtre appelle la routine DisconnectNotifyCall back chaque fois que le nombre de handles en mode utilisateur pour le port client atteint zéro ou lorsque le pilote minifilter est sur le point d’être déchargé.

FltCloseClientPort ferme un port client de communication créé par la routine ConnectNotifyCallback du pilote minifilter.

Lors de l’entrée, le paramètre clientPort est un pointeur vers une variable contenant le handle opaque pour que le port client soit fermé. Pour vous assurer que les messages envoyés par FltSendMessage sont synchronisés correctement lorsque le port du client de communication est fermé, FltCloseClientPort définit cette variable sur NULL.

Cette routine déconnecte une connexion spécifique du pilote minifilter. Pour fermer le handle du port de serveur du pilote minifilter, qui écoute les connexions entrantes, utilisez FltCloseCommunicationPort.