Fonction FltCloseClientPort (fltkernel.h)

Article
02/26/2024

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 avoir la valeur NULL.

[out] ClientPort

Pointeur vers une variable qui contient le handle de port opaque pour le port client à fermer. Au retour, la variable reçoit NULL. Ce paramètre est obligatoire et ne peut pas être NULL en entrée.

Valeur de retour

None

Remarques

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

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

En entrée, le paramètre ClientPort est un pointeur vers une variable contenant le handle opaque pour le port client à fermer. Pour garantir que tous les messages envoyés par FltSendMessage sont correctement synchronisés 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 de minifiltre. Pour fermer le handle du port serveur du pilote minifilter, qui écoute les connexions entrantes, utilisez FltCloseCommunicationPort.