FwpsPendClassify0, fonction (fwpsk.h)

La fonction classifieFn d’un légende appelle FwpsPendClassify0 pour pendre la requête de classification actuelle. Une fois la requête bloquée, le pilote de légende doit terminer le traitement de la demande de classification de façon asynchrone en appelant FwpsCompleteClassify0.

RemarqueFwpsPendClassify0 est une version spécifique de FwpsPendClassify. Pour plus d’informations, voir PAM Version-Independent noms et ciblage des versions spécifiques de 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 actuelle. Ce handle est obtenu en appelant FwpsAcquireClassifyHandle0.

[in] filterId

Valeur du membre FilterId du paramètre de filtre de la fonction classifiable. 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 le paramètre classOut de la fonction classFn du pilote de légende. Le paramètre classOut de classFn est répertorié comme 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 passé à FwpsPendClassify.

Valeur de retour

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

Code de retour Description
STATUS_SUCCESS
La demande de classification a été correctement bloquée.
STATUS_FWP_CANNOT_PEND
Le moteur n’autorise pas la classification asynchrone à partir de laquelle l’appel a été effectué.
Autres codes d’état
Une erreur est survenue.

Remarques

FwpsPendClassify0 place la classification de l’événement indiqué dans un état pendé. Un pilote de légende pend généralement la classification afin que davantage de traitement puisse être effectué en dehors de l’étendue de la fonction de légende classifiableFn . Le pilote de légende peut ensuite passer le handle de classification et toutes les autres données pertinentes relatives à l’indication à une fonction ayant moins d’impact sur les performances que les fonctions de légende du pilote. Lorsque le traitement est terminé, la légende doit appeler FwpsCompleteClassify0 pour supprimer l’état pendu. Au moment de l’appel à FwpsCompleteClassify, le pilote de légende doit retourner une structure de FWPS_CLASSIFY_OUT0 remplie comme elle le ferait dans une classification inline.

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

Configuration requise

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

Voir aussi

FWPS_CLASSIFY_OUT0

FWPS_FILTER1

FwpsAcquireClassifyHandle0

FwpsCompleteClassify0

FwpsReleaseClassifyHandle0

classFn