共用方式為


EXT_DELETE_PARAMETERS結構 (wdm.h)

EXT_DELETE_PARAMETERS 結構包含 ExDeleteTimer 例程的擴充參數集。

語法

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

成員

Version

這個 EXT_DELETE_PARAMETERS 結構的版本號碼。 ExInitializeDeleteTimerParameters 例程會將這個成員設定為正確的版本號碼。

Reserved

設定為零。 ExInitializeDeleteTimerParameters 例程會將這個成員設定為零。

DeleteCallback

驅動程序實作 ExTimerDeleteCallback 回 呼例程的指標。 刪除定時器時,作業系統會呼叫此例程。 此參數是選擇性的,如果不需要定時器刪除回呼例程,則可以是 NULL

ExInitializeDeleteTimerParameters 例程會將這個成員設定為 NULL。 如需詳細資訊,請參閱<備註>。

DeleteContext

定時器刪除回呼例程的內容值。 如果指定了這個值,作業系統會將此值當做參數傳遞至定時器刪除回呼例程。 此參數通常是呼叫端定義結構的指標,其中包含回呼例程所使用的內容資訊。 此參數是選擇性的,如果不需要任何內容資訊,則可以設定為 NULL

ExInitializeDeleteTimerParameters 例程會將這個成員設定為 NULL

備註

ExDeleteTimer 例程的 Parameters 參數是EXT_DELETE_PARAMETERS結構的指標。 將 EXT_DELETE_PARAMETERS 結構傳遞至這個例程之前,請先呼叫 ExInitializeDeleteTimerParameters 例程來初始化結構。

您的驅動程式可以使用 ExTimerDeleteCallback 回 呼例程來釋放驅動程式先前可能配置來與已刪除定時器物件搭配使用的任何記憶體或其他系統資源。 例如,如果要刪除定時器對象,驅動程式的內容值可能會指向需要釋放的呼叫端配置結構。 只有在停用定時器對象之後,操作系統才會呼叫 ExTimerDeleteCallback 例程,以防止進一步的定時器作業,而且定時器物件上的任何暫止定時器作業都會取消或完成。

規格需求

需求
最低支援的用戶端 從 Windows 8.1 開始支援。
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)

另請參閱

ExDeleteTimer

ExInitializeDeleteTimerParameters

ExTimerDeleteCallback