FwpsAcquireWritableLayerDataPointer0, fonction (fwpsk.h)

Article
02/07/2025

La fonction FwpsAcquireWritableLayerDataPointerDataPointer0 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 PAM Version-Independent noms et ciblage de versions spécifiques de 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 FilterId membre du paramètre de filtre classifiezFn fonction de filtre . Pour plus d’informations sur le membre FilterId, consultez FWPS_FILTER1.

[in] flags

Réservé pour une utilisation ultérieure. Défini sur 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, répertoriés dans la section Remarques suivantes, sont définis comme des structures. Lors du 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 classifieOut de la fonction classifiezFn 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é à FwpsAcquireWritableLayerDataPointer0.

Valeur de retour

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

Retourner le code	Description
STATUS_SUCCESS	La fonction de rappel a été correctement inscrite.
Autres codes d’état	Une erreur s’est produite.

Remarques

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

classifierout->actionType = FWP_ACTION_BLOCK
classifier->droits &= ~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, cela peut entraîner l’exécution correcte de la classification.

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 un des types suivants :

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 7.
plateforme cible	Universel
d’en-tête	fwpsk.h (include Fwpsk.h)
bibliothèque	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL