IO_CSQ_RELEASE_LOCK コールバック関数 (wdm.h)
CsqReleaseLock ルーチンは、CsqAcquireLockを使用して取得されたロックを解放するためにシステムによって使用されます。
構文
IO_CSQ_RELEASE_LOCK IoCsqReleaseLock;
void IoCsqReleaseLock(
[in] PIO_CSQ Csq,
[in] KIRQL Irql
)
{...}
パラメーター
[in] Csq
キャンセル セーフな IRP キューの IO_CSQ 構造体へのポインター。
[in] Irql
IRQL を指定します。 これは、ロックの取得時 CsqAcquireLock によって格納される値です。
戻り値
何一つ
備考
ドライバーは、キューの IO_CSQ 構造体を初期化するときに、キャンセル セーフ IRP キューの CsqReleaseLock ルーチンを指定します。 ドライバーは、IO_CSQを初期化するときに、IoCsqInitialize または IoCsqInitializeEx の CsqReleaseLock パラメーターとしてルーチンを指定します。 詳細については、「Cancel-Safe IRP キューの」を参照してください。
システムはこの関数を呼び出して、CsqAcquireLockを使用して取得されたロックを解放します。
ドライバーがスピン ロックを使用してキューのロックを実装する場合は、ロックを取得するときに現在の IRQL を格納し、ロックを解放するときに格納されている IRQL を提供する必要があります。 CsqAcquireLock ルーチンは現在の IRQL を格納し、システムは格納された値を Irql パラメーターとして渡して CsqReleaseLock をします。 それ以外の場合、ドライバーは、Irql パラメーターを無視できます。 スピン ロックの詳細については、「スピン ロックの 」を参照してください。
ドライバーは、ミューテックスなど、任意のロック メカニズムを使用してキューをロックできます。 ミューテックスの詳細については、「ミューテックス オブジェクトの 」を参照してください。
例
CsqReleaseLock コールバック ルーチンを定義するには、まず、定義するコールバック ルーチンの種類を識別する関数宣言を指定する必要があります。 Windows には、ドライバーのコールバック関数の種類のセットが用意されています。 コールバック関数の種類を使用して関数を宣言すると、ドライバー のコード分析、静的ドライバー検証ツール (SDV)、およびその他の検証ツールをすると、エラーが検出され、Windows オペレーティング システムのドライバーを記述するための要件になります。
たとえば、MyCsqReleaseLockという名前の CsqReleaseLock コールバック ルーチンを定義するには、次のコード例に示すようにIO_CSQ_RELEASE_LOCK型を使用します。
IO_CSQ_RELEASE_LOCK MyCsqReleaseLock;
次に、次のようにコールバック ルーチンを実装します。
_Use_decl_annotations_
VOID
MyCsqReleaseLock(
PIO_CSQ Csq,
KIRQL Irql
)
{
// Function body
}
IO_CSQ_RELEASE_LOCK関数の種類は、Wdm.h ヘッダー ファイルで定義されます。 コード分析ツールの実行時にエラーをより正確に識別するには、_Use_decl_annotations_ 注釈を関数定義に追加してください。
_Use_decl_annotations_ 注釈を使用すると、ヘッダー ファイル内のIO_CSQ_RELEASE_LOCK関数型に適用される注釈が使用されます。 関数宣言の要件の詳細については、「WDM ドライバーの の関数の役割の種類を使用して関数を宣言するを参照してください。
_Use_decl_annotations_の詳細については、「関数の動作 に注釈を付けるを参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
関連項目
IoCsqInitializeEx の
IoCsqInsertIrp の
IoCsqInsertIrpEx の