FwpsPendClassify0, fonction (fwpsk.h)

Article
02/29/2024

La fonction classifyFn d’une légende appelle FwpsPendClassify0 pour mettre en attente la demande de classification actuelle. Une fois la demande suspendu, le pilote de légende doit terminer le traitement de la demande de classification de manière asynchrone en appelant FwpsCompleteClassify0.

RemarqueFwpsPendClassify0 est une version spécifique de FwpsPendClassify. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .

Syntaxe

NTSTATUS FwpsPendClassify0(
  [in]      UINT64             classifyHandle,
  [in]      UINT64             filterId,
  [in]      UINT32             flags,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);

Paramètres

[in] classifyHandle

Handle de classification qui identifie le traitement du pilote de légende au niveau de la couche active. Ce handle est obtenu en appelant FwpsAcquireClassifyHandle0.

[in] filterId

Valeur du membre FilterId du paramètre de filtre de la fonction classifyFn. Pour plus d’informations sur le membre FilterId , consultez FWPS_FILTER1.

[in] flags

Réservé pour un usage futur. Définit la valeur zéro.

[in, out] classifyOut

Définissez sur le paramètre classifyOut de la fonction classifyFn du pilote de légende. Le paramètre classifyOut de classifyFn est répertorié en tant que paramètre de sortie dans l’en-tête, mais il contient suffisamment d’informations sur l’entrée pour être utile au moteur lorsqu’il est transmis à FwpsPendClassify.

Valeur retournée

La fonction FwpsPendClassify0 retourne l’un des codes NTSTATUS suivants.

Code de retour	Description
STATUS_SUCCESS	La demande de classification a été correctement suspendu.
STATUS_FWP_CANNOT_PEND	Le moteur n’autorise pas la classification asynchrone au niveau de la couche à partir de laquelle l’appel a été effectué.
Autres codes status	Une erreur est survenue.

Remarques

FwpsPendClassify0 place la classification de l’événement indiqué dans un état suspendu. Un pilote de légende met généralement en attente la classification afin que davantage de traitement puisse être effectué en dehors de l’étendue de la fonction de légende classifyFn . Le pilote de légende peut ensuite passer le handle de classification et toute autre donnée pertinente sur l’indication à une fonction ayant moins d’impact sur les performances que les fonctions de légende du pilote. Une fois le traitement terminé, la légende doit appeler FwpsCompleteClassify0 pour supprimer l’état suspendu. Au moment de l’appel à FwpsCompleteClassify, le pilote de légende doit retourner une structure de FWPS_CLASSIFY_OUT0 remplie comme dans une classification inline.

FwpsPendClassify0 incrémente le nombre de références pour le handle de classification passé dans le paramètre classifyHandle . Une fois que le pilote de légende a appelé cette fonction, il peut appeler FwpsReleaseClassifyHandle0 pour libérer la instance locale. Lorsque FwpsCompleteClassify0 est appelé, la référence au handle est décrémentée automatiquement.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 7.
Plateforme cible	Universal
En-tête	fwpsk.h (include Fwpsk.h)
Bibliothèque	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL