EXT_DELETE_PARAMETERS-Struktur (wdm.h)
Die EXT_DELETE_PARAMETERS-Struktur enthält einen erweiterten Satz von Parametern für die ExDeleteTimer-Routine .
Syntax
typedef struct _EXT_DELETE_PARAMETERS {
ULONG Version;
ULONG Reserved;
PEXT_DELETE_CALLBACK DeleteCallback;
PVOID DeleteContext;
} EXT_DELETE_PARAMETERS, *PEXT_DELETE_PARAMETERS;
Member
Version
Die Versionsnummer dieser EXT_DELETE_PARAMETERS-Struktur . Die ExInitializeDeleteTimerParameters-Routine legt diesen Member auf die richtige Versionsnummer fest.
Reserved
Auf NULL festlegen. Die ExInitializeDeleteTimerParameters-Routine legt diesen Member 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 sein, wenn keine Timerlösch-Rückrufroutine erforderlich ist.
Die ExInitializeDeleteTimerParameters-Routine legt diesen Member auf NULL fest. Weitere Informationen finden Sie in den Hinweisen.
DeleteContext
Ein Kontextwert für die Rückrufroutine zum Löschen von Zeitgebern. Das Betriebssystem übergibt diesen Wert als Parameter an die Timerlösch-Rückrufroutine, sofern angegeben. Dieser Parameter ist in der Regel ein Zeiger auf eine vom Aufrufer definierte Struktur, die kontextbezogene Informationen enthält, die von der Rückrufroutine verwendet werden. Dieser Parameter ist optional und kann auf NULL festgelegt werden, wenn keine Kontextinformationen benötigt werden.
Die ExInitializeDeleteTimerParameters-Routine legt diesen Member auf NULL fest.
Hinweise
Der Parameters-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 möglicherweise zuvor für die Verwendung mit dem zu löschenden Timerobjekt zugewiesen hat. Beispielsweise kann der Kontextwert des Treibers 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 Timervorgänge für das Timerobjekt abgebrochen oder abgeschlossen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt ab Windows 8.1. |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |