EXT_DELETE_CALLBACK コールバック関数 (wdm.h)
オペレーティング システムがEX_TIMER タイマー オブジェクトを削除すると、ExTimerDeleteCallback コールバック ルーチンが実行されます。
構文
EXT_DELETE_CALLBACK ExtDeleteCallback;
void ExtDeleteCallback(
[in, optional] PVOID Context
)
{...}
パラメーター
[in, optional] Context
ドライバーが ExDeleteTimer ルーチンに入力パラメーターとして渡したEXT_DELETE_PARAMETERS構造体の DeleteContext メンバーのコンテキスト値。
戻り値
なし
解説
オプションとして、ドライバーは、ExDeleteTimer ルーチンに入力パラメーターとして渡すEXT_DELETE_PARAMETERS構造体の DeleteCallback メンバーの ExTimerDeleteCallback ルーチンへのポインターを指定できます。 ExTimerDeleteCallback ルーチンは、削除されるタイマー オブジェクトで使用するためにドライバーが以前に割り当てたストレージまたはその他のシステム リソースを解放できます。
ドライバーが ExTimerDeleteCallback ルーチンを提供し、ExDeleteRoutine 呼び出しの Wait パラメーターが TRUE の場合、ExDeleteTimer が返される前に ExTimerDeleteCallback ルーチンが実行されます。 それ以外の場合、 ExTimerDeleteCallback ルーチンは 、ExDeleteTimer 呼び出しが返される前または後に実行される可能性があります。 ExTimerDeleteCallback ルーチンは、タイマー オブジェクトが無効にされた後にのみ呼び出され、タイマー 操作がそれ以上行われず、タイマー オブジェクトに対する保留中のタイマー操作が取り消されるか完了するのを防ぎます。 ドライバーが ExDeleteTimer ルーチンに入力パラメーターとして渡すタイマー オブジェクト (EX_TIMER構造体) は、ExTimerDeleteCallback ルーチンが実行されるまでに無効になる可能性があります。
詳細については、「 ExXxxTimer ルーチン」および「EX_TIMER オブジェクト」を参照してください。
例
ExTimerDeleteCallback コールバック ルーチンを定義するには、まず、定義するコールバック ルーチンの種類を識別する関数宣言を指定する必要があります。 Windows には、ドライバーのコールバック関数型のセットが用意されています。 コールバック関数の種類を使用して関数を宣言すると、 ドライバーのコード分析、 静的ドライバー検証ツール (SDV)、およびその他の検証ツールでエラーが検出され、Windows オペレーティング システムのドライバーを記述するための要件になります。
たとえば、 という名前MyExTimerDeleteCallbackの ExTimerDeleteCallback コールバック ルーチンを定義するには、次のコード例に示すように、EXT_DELETE_CALLBACK関数型を使用します。
EXT_DELETE_CALLBACK MyExTimerDeleteCallback;
次に、コールバック ルーチンを次のように実装します。
_Use_decl_annotations_
VOID
MyExTimerDeleteCallback(
PVOID Context
)
{...}
EXT_DELETE_CALLBACK関数の種類は、Wdm.h ヘッダー ファイルで定義されています。 コード分析ツールの実行時にエラーをより正確に識別するには、必ず注釈を _Use_decl_annotations_ 関数定義に追加してください。 注釈により _Use_decl_annotations_ 、ヘッダー ファイル内のEXT_DELETE_CALLBACK関数型に適用される注釈が確実に使用されます。 関数宣言の要件の詳細については、「 WDM ドライバーの関数ロール型を使用して関数を宣言する」を参照してください。 の詳細については _Use_decl_annotations_、「 関数の動作に注釈を付ける」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8.1 以降で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| IRQL | DISPATCH_LEVELで呼び出されます。 |