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

0 に設定します。 ExInitializeDeleteTimerParameters ルーチンは、このメンバーを 0 に設定します。

DeleteCallback

ドライバーによって実装された ExTimerDeleteCallback コールバック ルーチンへのポインター。 オペレーティング システムは、タイマーが削除されたときにこのルーチンを呼び出します。 このパラメーターは省略可能であり、タイマー削除コールバック ルーチンが必要ない場合は NULL にすることができます。

ExInitializeDeleteTimerParameters ルーチンは、このメンバーを NULL に設定します。 詳細については、「解説」を参照してください。

DeleteContext

タイマー削除コールバック ルーチンのコンテキスト値。 オペレーティング システムは、タイマー削除コールバック ルーチンが指定されている場合、この値をパラメーターとして渡します。 通常、このパラメーターは、コールバック ルーチンで使用されるコンテキスト情報を含む呼び出し元定義構造体へのポインターです。 このパラメーターは省略可能であり、コンテキスト情報が必要ない場合は NULL に 設定できます。

ExInitializeDeleteTimerParameters ルーチンは、このメンバーを NULL に設定します。

注釈

ExDeleteTimer ルーチンの Parameters パラメーターは、EXT_DELETE_PARAMETERS構造体へのポインターです。 このルーチンにEXT_DELETE_PARAMETERS構造体を渡す前に、ExInitializeDeleteTimerParameters ルーチンを呼び出して構造体を初期化します。

ドライバーは、 ExTimerDeleteCallback コールバック ルーチンを使用して、削除されるタイマー オブジェクトで使用するためにドライバーが以前に割り当てた可能性がある記憶域またはその他のシステム リソースを解放できます。 たとえば、ドライバーのコンテキスト値は、タイマー オブジェクトを削除する場合に解放する必要がある呼び出し元によって割り当てられた構造体を指している可能性があります。 オペレーティング システムは、タイマー オブジェクトを無効にした後にのみ ExTimerDeleteCallback ルーチンを呼び出して、タイマー操作を停止し、タイマー オブジェクトに対する保留中のタイマー操作が取り消されるか完了するのを防ぎます。

要件

こちらもご覧ください

ExDeleteTimer

ExInitializeDeleteTimerParameters

ExTimerDeleteCallback