PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK fonction de rappel (ntifs.h)

Article
02/29/2024

Un pilote de filtre peut inscrire une routine de type PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK en tant que routine de rappel CleanupCallback du pilote de filtre pour une structure de contexte de paramètre de création supplémentaire (ECP).

Syntaxe

PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK PfsrtlExtraCreateParameterCleanupCallback;

void PfsrtlExtraCreateParameterCleanupCallback(
  [in, out] PVOID EcpContext,
  [in[]     LPCGUID EcpType
)
{...}

Paramètres

[in, out] EcpContext

Pointeur de contexte ECP retourné par la routine qui a alloué la structure de contexte ECP.

[in[] EcpType

Pointeur vers un GUID qui a été passé à la routine qui a alloué la structure de contexte ECP, qui indique le type de paramètre create supplémentaire. Pour plus d’informations, consultez Utilisation de GUID dans les pilotes.

Valeur de retour

None

Remarques

Lorsqu’un pilote de filtre alloue une structure de contexte ECP, il peut éventuellement spécifier une routine de type PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK comme routine de rappel CleanupCallback du pilote de filtre. Si le pilote de filtre spécifie une routine de rappel CleanupCallback , le système d’exploitation appelle la routine CleanupCallback (quel que soit le niveau IRQ). Cette routine CleanupCallback effectue tout traitement de nettoyage lié au contexte ECP nécessaire lorsque la structure de contexte ECP est supprimée.

Pour spécifier une routine de rappel, un pilote de filtre passe un pointeur vers la routine de rappel à l’aide du paramètre CleanupCallback de la routine qui a initialement alloué la structure de contexte ECP. Si aucune routine de rappel n’est nécessaire, une valeur NULL doit être passée au paramètre CleanupCallback .

Les routines suivantes prennent en charge la routine de rappel PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK typée :

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ntifs.h (include Ntifs.h, FltKernel.h)
IRQL	PASSIVE_LEVEL