FwpsPendClassify0, fonction (fwpsk.h)
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.
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 |
|---|---|
|
La demande de classification a été correctement suspendu. |
|
Le moteur n’autorise pas la classification asynchrone au niveau de la couche à partir de laquelle l’appel a été effectué. |
|
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 |