ExCancelTimer 関数 (wdm.h)
ExCancelTimer ルーチンは、ExSetTimer ルーチンへの以前の呼び出しによって設定されたタイマーを取り消します。
構文
BOOLEAN ExCancelTimer(
[in, out] PEX_TIMER Timer,
[in, optional] PEXT_CANCEL_PARAMETERS Parameters
);
パラメーター
[in, out] Timer
EX_TIMER 構造体へのポインター。 この構造体は、以前に ExAllocateTimer ルーチンによって割り当てられたタイマー オブジェクトです。
[in, optional] Parameters
ドライバーは、このパラメーターを NULL 設定する必要があります。
戻り値
このルーチンは、タイマーが取り消された場合 TRUE を返します。 それ以外の場合、ルーチンは FALSE 返します。
備考
ドライバーが ExSetTimer ルーチンを呼び出してタイマーを設定した後、タイマーが期限切れになる前に取り消される可能性があります。 ドライバーは、ExCancelTimer ルーチンを呼び出して、保留中のタイマーを明示的に取り消すことができます。 また、このオブジェクトに対して以前に設定したタイマーの有効期限が切れる前に、ドライバーが ExSetTimer ルーチンを呼び出してタイマー オブジェクトに新しいタイマーを設定した場合、この ExSetTimer 呼び出しは、以前のタイマーを暗黙的にキャンセルしてから、新しいタイマーを開始します。
戻り値 TRUE は、ExCancelTimer が呼び出されたときにタイマー 設定されたことを示します。 この場合、ルーチンはタイマーを取り消します。 FALSE の戻り値は、タイマーが設定されていないこと、タイマーが設定されなかったこと、タイマーが既に取り消されていること、またはタイマーが既に期限切れであることを意味する可能性があることを示します。 タイマーが取り消される前に期限切れになると、ExCancelTimer は FALSE を返し、タイマーはシグナル状態のままになります。
タイマーの有効期限が切れると、オペレーティング システムはタイマー オブジェクトに通知します。 オプションとして、ドライバーは、タイマーの有効期限が切れたときに呼び出される ExTimerCallback コールバック ルーチンを提供できます。 ドライバーがこのコールバック ルーチンを提供する場合は、タイマー オブジェクトが通知された場合、このルーチンが呼び出されることが保証されます。 タイマーが期限切れになる前に取り消された場合、タイマー オブジェクトは通知されず、コールバック ルーチンは呼び出されません。
詳細については、「ExXxxTimer ルーチンとEX_TIMER オブジェクト する」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8.1 以降で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| ライブラリ | Ntoskrnl.lib |
| IRQL | <= DISPATCH_LEVEL |
関連項目
ExAllocateTimer の
ExSetTimer の