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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge à partir de Windows 8.1. |
| En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |