structure EXT_DELETE_PARAMETERS (wdm.h)

La structure EXT_DELETE_PARAMETERS contient un ensemble étendu de paramètres pour la routine ExDeleteTimer .

Syntaxe

typedef struct _EXT_DELETE_PARAMETERS {
  ULONG                Version;
  ULONG                Reserved;
  PEXT_DELETE_CALLBACK DeleteCallback;
  PVOID                DeleteContext;
} EXT_DELETE_PARAMETERS, *PEXT_DELETE_PARAMETERS;

Membres

Version

Numéro de version de cette structure EXT_DELETE_PARAMETERS . La routine ExInitializeDeleteTimerParameters définit ce membre sur le numéro de version correct.

Reserved

Définit la valeur zéro. La routine ExInitializeDeleteTimerParameters définit ce membre sur zéro.

DeleteCallback

Pointeur vers une routine de rappel ExTimerDeleteCallback implémentée par le pilote. Le système d’exploitation appelle cette routine lorsque le minuteur est supprimé. Ce paramètre est facultatif et peut être NULL si aucune routine de rappel de suppression du minuteur n’est nécessaire.

La routine ExInitializeDeleteTimerParameters définit ce membre sur NULL. Pour plus d'informations, consultez la section Notes.

DeleteContext

Valeur de contexte pour la routine de rappel de suppression du minuteur. Le système d’exploitation transmet cette valeur en tant que paramètre à la routine de rappel de suppression du minuteur, si elle est spécifiée. Ce paramètre est généralement un pointeur vers une structure définie par l’appelant qui contient des informations de contexte utilisées par la routine de rappel. Ce paramètre est facultatif et peut être défini sur NULL si aucune information de contexte n’est nécessaire.

La routine ExInitializeDeleteTimerParameters définit ce membre sur NULL.

Remarques

Le paramètre Parameters de la routine ExDeleteTimer est un pointeur vers une structure EXT_DELETE_PARAMETERS . Avant de passer une structure EXT_DELETE_PARAMETERS à cette routine, appelez la routine ExInitializeDeleteTimerParameters pour initialiser la structure.

Votre pilote peut utiliser une routine de rappel ExTimerDeleteCallback pour libérer le stockage ou d’autres ressources système que le pilote a précédemment allouées à utiliser avec l’objet minuteur en cours de suppression. Par exemple, la valeur de contexte du pilote peut pointer vers une structure allouée par l’appelant qui doit être libérée si l’objet minuteur doit être supprimé. Le système d’exploitation appelle la routine ExTimerDeleteCallback uniquement après que l’objet du minuteur a été désactivé pour empêcher d’autres opérations du minuteur et que toute opération de minuteur en attente sur l’objet minuteur est annulée ou terminée.

Configuration requise

Voir aussi

ExDeleteTimer

ExInitializeDeleteTimerParameters

ExTimerDeleteCallback