EXT_DELETE_PARAMETERS-Struktur (wdm.h)

  • Artikel

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)

Weitere Informationen

ExDeleteTimer

ExInitializeDeleteTimerParameters

ExTimerDeleteCallback