IoCsqInsertIrpEx 函式 (wdm.h)
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 佇列。
請注意， IoCsqXxx 例程使用 IRP 的 DriverContext[3] 成員來保存 IRP 內容資訊。 使用這些例程將 IRP 排入佇列的驅動程式必須讓該成員保持未使用。
IoCsqInsertIrpEx 的呼叫端必須在 IRQL <= DISPATCH_LEVEL上執行。 驅動程式的回呼例程必須在此 IRQL 正常運作。