FwpsAcquireWritableLayerDataPointer0, fonction (fwpsk.h)

Article
02/26/2024

La fonction FwpsAcquireWritableLayerDataPointer0 retourne des données spécifiques à la couche qui peuvent être inspectées et modifiées.

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

Syntaxe

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

Paramètres

[in] classifyHandle

Handle pour la demande de classification. 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.

[out] writableLayerData

Mémoire tampon de données qui contient les données modifiables pour la couche. Les types de données pris en charge, qui sont répertoriés dans la section Remarques suivante, sont définis en tant que structures. Au retour, les données sont accessibles en cas de conversion du pointeur void vers le type de structure approprié.

[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 à FwpsAcquireWritableLayerDataPointer0.

Valeur retournée

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

Code de retour	Description
STATUS_SUCCESS	La fonction de rappel a été correctement inscrite.
Autres codes status	Une erreur est survenue.

Remarques

FwpsAcquireWritableLayerDataPointer0 définit les membres suivants de la structure FWPS_CLASSIFY_OUT0 :

classout->actionType = FWP_ACTION_BLOCK
classout->rights &= ~FWPS_RIGHT_ACTION_WRITE

Pour chaque appel à cette fonction, vous devez effectuer un appel correspondant à FwpsApplyModifiedLayerData0 pour finaliser les modifications qui ont été apportées, même si votre pilote de légende n’a pas modifié de données. Si vous n’effectuez pas l’appel à FwpsApplyModifiedLayerData0, la classification peut ne pas se terminer correctement.

Les structures suivantes sont définies pour contenir des données de couche modifiables. Le pointeur défini sur la sortie en tant que paramètre writableLayerData peut être converti en l’un des types suivants :

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