次の方法で共有


IO_CSQ_REMOVE_IRP コールバック関数 (wdm.h)

CsqRemoveIrp ルーチンは、ドライバー実装のキャンセル セーフ IRP キューから指定された IRP を削除するシステムによって使用されます。

構文

IO_CSQ_REMOVE_IRP IoCsqRemoveIrp;

void IoCsqRemoveIrp(
  [in] PIO_CSQ Csq,
  [in] PIRP Irp
)
{...}

パラメーター

[in] Csq

キャンセル セーフ IRP キューの IO_CSQ 構造体へのポインター。

[in] Irp

IRP キューから削除する IRP へのポインター。

戻り値

なし

解説

ドライバーは、キューのIO_CSQ構造を初期化するときに、キャンセル セーフ IRP キューの CsqRemoveIrp ルーチン 指定します。 ドライバーは、IO_CSQを初期化するときに、IoCsqInitialize または IoCsqInitializeExCsqRemoveIrp パラメーターとしてルーチン指定します。 詳細については、「 Cancel-Safe IRP Queues」を参照してください。

IoCsqRemoveIrp および IoCsqRemoveNextIrp ルーチンは、キャンセル セーフ IRP キューの CsqRemoveIrp ルーチンを呼び出して、指定した IRP をキューから削除します。 また、システムは CsqRemoveIrp を使用して、キャンセルされた IRP をキューから削除します。

CsqRemoveIrp コールバック ルーチンを定義するには、まず、定義するコールバック ルーチンの種類を識別する関数宣言を指定する必要があります。 Windows には、ドライバーのコールバック関数の種類のセットが用意されています。 コールバック関数の種類を使用して関数を宣言すると、ドライバー、静的ドライバー検証ツール (SDV)、およびその他の検証ツールのコード分析でエラーが検出され、Windows オペレーティング システム用のドライバーを記述するための要件になります。

たとえば、 という名前MyCsqRemoveIrpの CsqRemoveIrp コールバック ルーチンを定義するには、次のコード例に示すように、IO_CSQ_REMOVE_IRP型を使用します。

IO_CSQ_REMOVE_IRP MyCsqRemoveIrp;

次に、コールバック ルーチンを次のように実装します。

_Use_decl_annotations_
VOID 
 MyCsqRemoveIrp(
    PIO_CSQ  Csq,
    PIRP  Irp
    )
  {
      // Function body
  }

IO_CSQ_REMOVE_IRP関数の種類は、Wdm.h ヘッダー ファイルで定義されます。 コード分析ツールを実行するときにエラーをより正確に識別するには、必ず注釈を _Use_decl_annotations_ 関数定義に追加してください。 注釈を _Use_decl_annotations_ 使用すると、ヘッダー ファイル内のIO_CSQ_REMOVE_IRP関数型に適用される注釈が確実に使用されます。 関数宣言の要件の詳細については、「 WDM ドライバーの関数ロール型を使用して関数を宣言する」を参照してください。 の詳細 _Use_decl_annotations_については、「 関数の動作に注釈を付ける」を参照してください。

要件

要件
対象プラットフォーム デスクトップ
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)

こちらもご覧ください

CsqAcquireLock

CsqCompleteCanceledIrp

CsqInsertIrp

CsqInsertIrpEx

CsqPeekNextIrp

CsqReleaseLock

IO_CSQ

IoCsqInitialize

IoCsqInitializeEx

IoCsqInsertIrp

IoCsqInsertIrpEx

IoCsqRemoveIrp

IoCsqRemoveNextIrp