IoCsqInitialize 関数 (wdm.h)

[アーティクル]
02/27/2024

IoCsqInitialize ルーチンは、ドライバーのキャンセルセーフ IRP キューディスパッチテーブルを初期化します。

構文

NTSTATUS IoCsqInitialize(
  [out] PIO_CSQ                       Csq,
  [in]  PIO_CSQ_INSERT_IRP            CsqInsertIrp,
  [in]  PIO_CSQ_REMOVE_IRP            CsqRemoveIrp,
  [in]  PIO_CSQ_PEEK_NEXT_IRP         CsqPeekNextIrp,
  [in]  PIO_CSQ_ACQUIRE_LOCK          CsqAcquireLock,
  [in]  PIO_CSQ_RELEASE_LOCK          CsqReleaseLock,
  [in]  PIO_CSQ_COMPLETE_CANCELED_IRP CsqCompleteCanceledIrp
);

パラメーター

[out] Csq

IoCsqInitialize によって初期化されるIO_CSQ構造体へのポインター。

[in] CsqInsertIrp

ドライバーのキャンセルセーフ IRP キューのドライバー定義の CsqInsertIrp 関数へのポインター。

[in] CsqRemoveIrp

ドライバーのキャンセルセーフ IRP キューのドライバー定義 CsqRemoveIrp 関数へのポインター。

[in] CsqPeekNextIrp

ドライバーのキャンセルセーフ IRP キューのドライバー定義 CsqPeekNextIrp 関数へのポインター。

[in] CsqAcquireLock

ドライバーのキャンセルセーフ IRP キューのドライバー定義 CsqAcquireLock 関数へのポインター。

[in] CsqReleaseLock

ドライバーのキャンセルセーフ IRP キューのドライバー定義 CsqReleaseLock 関数へのポインター。

[in] CsqCompleteCanceledIrp

ドライバーのキャンセルセーフ IRP キューのドライバー定義 CsqCompleteCanceledIrp 関数へのポインター。

戻り値

このルーチンは、成功した場合はSTATUS_SUCCESS、失敗した場合は適切な NTSTATUS エラーコードを返します。

注釈

IoCsqInitialize ルーチンは、ドライバーのキャンセルセーフ IRP キューを記述するIO_CSQ構造体を初期化します。ドライバーは、IoCsqInitializeEx を使用して、拡張機能を備えた IRP キューを作成することもできます。詳細については、「 Cancel-Safe IRP Queues」を参照してください。

IoCsqXxx ルーチンでは、IRP の DriverContext[3] メンバーを使用して IRP コンテキスト情報を保持します。これらのルーチンを使用して IRP をキューに入れるドライバーは、そのメンバーを使用しないようにする必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows XP 以降のバージョンの Windows オペレーティングシステムで使用できます。 Windows 2000 および Windows 98/Me でも動作する必要があるドライバーは、代わりに Csq.lib にリンクしてルーチンを使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	任意のレベル