EXT_DELETE_PARAMETERS Struktur (wdm.h)
Die EXT_DELETE_PARAMETERS-Struktur enthält einen erweiterten Satz von Parametern für die ExDeleteTimer- Routine.
typedef struct _EXT_DELETE_PARAMETERS {
ULONG Version;
ULONG Reserved;
PEXT_DELETE_CALLBACK DeleteCallback;
PVOID DeleteContext;
} EXT_DELETE_PARAMETERS, *PEXT_DELETE_PARAMETERS;
Version
Die Versionsnummer dieser EXT_DELETE_PARAMETERS Struktur. Die ExInitializeDeleteTimerParameters Routine legt dieses Element auf die richtige Versionsnummer fest.
Reserved
Auf Null festgelegt. Die ExInitializeDeleteTimerParameters Routine legt dieses Element auf Null fest.
DeleteCallback
Ein Zeiger auf eine vom Treiber implementierte ExTimerDeleteCallback Rückrufroutine. Das Betriebssystem ruft diese Routine auf, wenn der Timer gelöscht wird. Dieser Parameter ist optional und kann NULL- werden, wenn keine Timerlöschrückrufroutine erforderlich ist.
Die ExInitializeDeleteTimerParameters- Routine legt dieses Element auf NULL-fest. Weitere Informationen finden Sie in den Hinweisen.
DeleteContext
Ein Kontextwert für die Timerlöschrückrufroutine. Das Betriebssystem übergibt diesen Wert als Parameter an die Timerlöschrückrufroutine, sofern angegeben. Dieser Parameter ist in der Regel ein Zeiger auf eine vom Aufrufer definierte Struktur, die Kontextinformationen enthält, die von der Rückrufroutine verwendet werden. Dieser Parameter ist optional und kann auf NULL- festgelegt werden, wenn keine Kontextinformationen erforderlich sind.
Die ExInitializeDeleteTimerParameters- Routine legt dieses Element auf NULL-fest.
Der Parameter Parameter der ExDeleteTimer Routine ist ein Zeiger auf eine EXT_DELETE_PARAMETERS Struktur. Rufen Sie vor dem Übergeben einer EXT_DELETE_PARAMETERS Struktur an diese Routine die ExInitializeDeleteTimerParameters Routine auf, um die Struktur zu initialisieren.
Ihr Treiber kann eine ExTimerDeleteCallback- Rückrufroutine verwenden, um speicher- oder andere Systemressourcen freizugeben, die der Treiber zuvor für die Verwendung mit dem timer-Objekt zugewiesen hat, das gelöscht wird. Der Kontextwert des Treibers kann beispielsweise auf eine vom Aufrufer zugewiesene Struktur verweisen, die freigegeben werden muss, wenn das Timerobjekt gelöscht werden soll. Das Betriebssystem ruft die ExTimerDeleteCallback- Routine erst auf, nachdem das Timerobjekt deaktiviert wurde, um weitere Zeitgebervorgänge zu verhindern und alle ausstehenden Zeitgebervorgänge für das Timerobjekt abgebrochen oder abgeschlossen werden.
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 8.1 unterstützt. |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |