IO_CSQ_INSERT_IRP_EX コールバック関数 (wdm.h)
CsqInsertIrpEx ルーチンは、ドライバー実装のキャンセル セーフ IRP キューに IRP を挿入するためにシステムによって使用されます。
構文
IO_CSQ_INSERT_IRP_EX IoCsqInsertIrpEx;
NTSTATUS IoCsqInsertIrpEx(
[in] _IO_CSQ *Csq,
[in] PIRP Irp,
[in] PVOID InsertContext
)
{...}
パラメーター
[in] Csq
キャンセル セーフな IRP キューの IO_CSQ 構造体へのポインター。
[in] Irp
IRP キューに挿入する IRP へのポインター。
[in] InsertContext
挿入操作のドライバー定義コンテキストへのポインター。
戻り値
CsqInsertIrpEx は、IRP が正常に挿入された場合はSTATUS_SUCCESSを返し、失敗した場合は適切なエラー コードを返します。
備考
ドライバーは、キューの IO_CSQ 構造体を初期化するときに、キャンセル セーフ IRP キューの CsqInsertIrpEx ルーチンを指定します。 ドライバーは、IO_CSQを初期化するときに、IoCsqInitializeEx の CsqInsertIrp パラメーターとしてルーチンを指定します。 詳細については、「Cancel-Safe IRP キューの」を参照してください。
IoCsqInsertIrpEx ルーチンは、キューに IRP を挿入 CsqInsertIrpEx を呼び出します。 IoCsqInsertIrpEx の InsertContext パラメーターは、CsqInsertIrpExの InsertContext パラメーターとして渡されます。
例
CsqInsertIrpEx コールバック ルーチン を定義するには、まず、定義するコールバック ルーチンの種類を識別する関数宣言を指定する必要があります。 Windows には、ドライバーのコールバック関数の種類のセットが用意されています。 コールバック関数の種類を使用して関数を宣言すると、ドライバー のコード分析、静的ドライバー検証ツール (SDV)、およびその他の検証ツールをすると、エラーが検出され、Windows オペレーティング システムのドライバーを記述するための要件になります。
たとえば、MyCsqInsertIrpExという名前の CsqInsertIrpEx コールバック ルーチンを定義するには、次のコード例に示すようにIO_CSQ_INSERT_IRP_EX型を使用します。
IO_CSQ_INSERT_IRP_EX MyCsqInsertIrpEx;
次に、次のようにコールバック ルーチンを実装します。
_Use_decl_annotations_
NTSTATUS
MyCsqInsertIrpEx(
struct _IO_CSQ *Csq,
PIRP Irp,
PVOID InsertContext
)
{
// Function body
}
IO_CSQ_INSERT_IRP_EX関数の種類は、Wdm.h ヘッダー ファイルで定義されています。 コード分析ツールの実行時にエラーをより正確に識別するには、_Use_decl_annotations_ 注釈を関数定義に追加してください。
_Use_decl_annotations_ 注釈により、ヘッダー ファイル内のIO_CSQ_INSERT_IRP_EX関数型に適用される注釈が確実に使用されます。 関数宣言の要件の詳細については、「WDM ドライバーの の関数の役割の種類を使用して関数を宣言するを参照してください。
_Use_decl_annotations_の詳細については、「関数の動作 に注釈を付けるを参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
関連項目
IoCsqInitializeEx の
IoCsqInsertIrp の
IoCsqInsertIrpEx の