IoCsqRemoveIrp 函式 (wdm.h)

IoCsqRemoveIrp 例程會從佇列中移除特定的 IRP。

語法

PIRP IoCsqRemoveIrp(
  [in, out] PIO_CSQ             Csq,
  [in, out] PIO_CSQ_IRP_CONTEXT Context
);

[in, out] Csq

驅動程式取消安全 IRP 佇列 IO_CSQ結構的指標。這個結構必須由 IoCsqInitialize 或 IoCsqInitializeEx初始化。

[in, out] Context

識別要移除之 IRP 之 IO_CSQ_IRP_CONTEXT 結構的指標。當 IRP 第一次插入佇列時，IoCsqInsertIrp 或 IoCsqInsertIrpEx 會初始化IO_CSQ_IRP_CONTEXT結構。

這個例程會傳回已從佇列中移除之 IRP 的指標，如果已取消該 IRP，則傳回 NULL 。

IoCsqRemoveIrp 會使用佇列的分派例程來移除 IRP。 IoCsqRemoveIrp 例程：

驅動程式可以使用 IoCsqRemoveNextIrp 例程來移除符合特定準則的 IRP。如需詳細資訊，請參閱取消安全 IRP 佇列。

請注意， IoCsqXxx 例程使用 IRP 的 DriverContext[3] 成員來保存 IRP 內容資訊。使用這些例程將 IRP 排入佇列的驅動程式必須讓該成員保持未使用。

IoCsqRemoveIrp 的呼叫端必須在 IRQL <= DISPATCH_LEVEL執行。驅動程式的回呼例程必須在該 IRQL 正常運作。

需求	值
最低支援的用戶端	可在 Windows XP 和更新版本的 Windows 中使用。也必須在 Windows 2000 和 Windows 98/Me 中運作的驅動程式可以改為連結到 Csq.lib，以使用例程。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (请参阅一节)