PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK fonction de rappel (ntifs.h)

Article
12/21/2024

Un pilote de filtre peut inscrire une routine PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK typée en tant que routine de rappel CleanupCallback du pilote de filtre pour une structure de contexte 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 passé à la routine qui a alloué la structure de contexte ECP, qui indique le type de paramètre de création supplémentaire. Pour plus d’informations, consultez Utilisation des GUID dans les pilotes.

Valeur de retour

Aucun

Remarques

Lorsqu’un pilote de filtre alloue une structure de contexte ECP, il peut éventuellement spécifier une routine PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK typée comme routine de rappel CleanupCallback du pilote de filtre routine de rappel. 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 cleanupCallback routine 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 transmet un pointeur à la routine de rappel à l’aide du paramètre CleanupCallback de la routine qui a initialement alloué la structure de contexte ECP. Si une routine de rappel n’est pas nécessaire, une valeur NULL doit être transmise au paramètre CleanupCallback .

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