IoCsqInsertIrpEx 函式 (wdm.h)

發行項
02/27/2024

IoCsqInsertIrpEx 例程會將 IRP 插入驅動程式的取消安全 IRP 佇列中。

語法

NTSTATUS IoCsqInsertIrpEx(
  [in, out]       PIO_CSQ             Csq,
  [in, out]       PIRP                Irp,
  [out, optional] PIO_CSQ_IRP_CONTEXT Context,
  [in, optional]  PVOID               InsertContext
);

參數

[in, out] Csq

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

[in, out] Irp

要排入佇列之 IRP 的指標。

[out, optional] Context

IO_CSQ_IRP_CONTEXT 結構的指標。 IoCsqInsertIrpEx 會使用插入 IRP 的內容資訊，初始化此結構。驅動程式會將此值傳遞至 IoCsqRemoveIrp ，以從佇列中刪除 IRP。如果驅動程式不會使用IoCsqRemoveIrp從佇列中移除此 IRP，則內容可以是 NULL。

[in, optional] InsertContext

驅動程式定義的內容值的指標。如果驅動程式的 CsqInsertIrpEx 例程有此參數，此參數就會傳遞至該參數。否則，會忽略此參數。

傳回值

如果 Csq 參數是以 IoCsqInitialize 初始化，IoCsqInsertIrpEx 一律會傳回STATUS_SUCCESS。如果使用 IoCsqInitializeEx 初始化 Csq，IoCsqInsertIrpEx 會傳回驅動程式的 CsqInsertIrpEx 例程所傳回的值。

備註

IoCsqInsertIrpEx 會使用佇列的分派例程來插入 IRP。 IoCsqInsertIrpEx 例程：

呼叫佇列的 CsqAcquireLock 例程來鎖定佇列。
如果佇列的 IO_CSQ 結構是由 IoCsqInitialize 初始化， IoCsqInsertIrpEx 會呼叫佇列的 CsqInsertIrp 例程來插入 IRP。如果佇列的IO_CSQ結構是由 IoCsqInitializeEx 初始化，IoCsqInsertIrpEx 會呼叫佇列的 CsqInsertIrpEx 例程來插入 IRP，並將 InsertContext 參數當做 CsqInsertIrpEx 的 InsertContext 參數傳遞。
呼叫佇列的 CsqReleaseLock 例程來解除鎖定佇列。

如果已取消要插入的 IRP，IoCsqInsertIrpEx 不會嘗試將 IRP 插入佇列。

如需詳細資訊，請參閱取消安全 IRP 佇列。

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

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

規格需求

需求	值
最低支援的用戶端	可在 Windows Server 2003 和更新版本的 Windows 作業系統中使用。此例程也位於隨附於適用於 Windows Server 2003 的 Windows Driver Kit (WDK) 和驅動程式開發工具包 (DDK) 的 Csq.lib 連結庫中。也必須在 Windows XP、Windows 2000 和 Windows 98/Me 上運作的驅動程式可以改為連結到 Csq.lib，以使用例程。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (请参阅一节)
DDI 合規性規則	IoAllocateFree (wdm) 、 IoReuseIrp (wdm ) 、 IrpCancelField (wdm ) 、 RemoveLockCheck (wdm ) 、 RemoveLockForward (wdm) 、 RemoveLockForward2 (wdm) 、 RemoveLockForwardDeviceControl (wdm) 、 RemoveLockForwardDeviceControl2 (wdm ) 、 RemoveLockForwardDeviceControlInternal (wdm) 、 RemoveLockForwardDeviceControlInternal2 (wdm) 、 RemoveLockForwardRead (wdm) 、 RemoveLockForwardRead2 (wdm ) 、 RemoveLockForwardWrite (wdm) 、 RemoveLockForwardWrite2 (wdm) 、 RemoveLockReleaseCleanup (wdm) ) 、 RemoveLockReleaseClose (wdm) 、 RemoveLockReleaseCreate (wdm ) 、 RemoveLockReleaseDeviceControl (wdm) 、 RemoveLockReleaseInternalDeviceControl (wdm) 、 RemoveLockReleasePower (wdm) 、 RemoveLockReleaseRead (wdm ) 、 RemoveLockReleaseShutdown (wdm) 、 RemoveLockReleaseSystemControl (wdm) 、 RemoveLockReleaseWrite (wdm)