EVT_WDF_IO_IN_CALLER_CONTEXT回呼函式 (wdfdevice.h)

[僅適用於 KMDF]

驅動程式的 EvtIoInCallerContext 事件回呼函式會在架構將它放入 I/O 佇列之前，預先處理 I/O 要求。

語法

EVT_WDF_IO_IN_CALLER_CONTEXT EvtWdfIoInCallerContext;

void EvtWdfIoInCallerContext(
  [in] WDFDEVICE Device,
  [in] WDFREQUEST Request
)
{...}

參數

[in] Device

架構裝置物件的句柄。

[in] Request

架構要求物件的句柄。

傳回值

無

備註

架構會呼叫驅動程式的 EvtIoInCallerContext 回呼函式，讓驅動程式可以檢查每個 I/O 要求，並在架構將它放在 I/O 佇列之前，對要求執行初步處理。 若要註冊裝置的 EvtIoInCallerContext 回呼函式，驅動程式會呼叫 WdfDeviceInitSetIoInCallerContextCallback。

如果驅動程式為裝置註冊 EvtIoInCallerContext 回呼函式，則架構會在每次收到裝置的 I/O 要求時呼叫回呼函式。 回呼函式會在傳送 I/O 要求給驅動程式的進程線程內容中呼叫。 此程式是下一個較高層級的驅動程式，如果驅動程式位於驅動程式堆疊的頂端，則為使用者模式應用程式。

此回呼函式的主要目的是讓架構型驅動程式支援 未緩衝處理或直接 I/O 呼叫的緩衝區存取方法。 對於這個緩衝區存取方法，驅動程式必須存取來源進程內容中收到的緩衝區。

在回呼函式取得要求的緩衝區之後，它可以將緩衝區位址或句柄儲存在要求對象的內容記憶體中。 (驅動程式會呼叫 WdfDeviceInitSetRequestAttributes.) 來設定要求對象的內容儲存區域大小

因為要求還不屬於 I/O 佇列，所以架構不會鎖定或同步處理要求。 驅動程式負責任何可能需要的同步處理。 如需同步處理的詳細資訊，請參閱 Framework-Based 驅動程式的同步處理技術。

在回呼函式完成前置處理要求之後，它必須呼叫 WdfDeviceEnqueueRequest 將它排入佇列，或在偵測到錯誤) 時呼叫 WdfRequestComplete (來完成它。

如需 EvtIoInCallerContext 回呼函式的詳細資訊，請參閱在排入佇列並存取 Framework-Based 驅動程式中的數據緩衝區之前攔截 I/O 要求。

如果驅動程式已設定 I/O 佇列以支持 保證的向前進度，架構可能不會在低記憶體的情況下呼叫驅動程式的 EvtIoInCallerContext 回呼 函式。 如果所有架構的保留要求物件都正在使用中，架構會延後處理 I/O 要求，直到有保留的要求物件可用為止。 在此情況下，架構無法針對延後 I/O 要求呼叫 EvtIoInCallerContext 回呼函式，因為當保留的要求物件可供使用時，架構將不再在傳送 I/O 要求給驅動程式的進程線程內容中執行。

EvtIoInCallerContext 回呼函式是在呼叫線程的 IRQL 上呼叫。 如果呼叫線程來自使用者模式應用程式，則會在 IRQL = PASSIVE_LEVEL呼叫回呼函式。 如果呼叫線程來自較高層級的核心模式驅動程式，則可以在 IRQL = DISPATCH_LEVEL呼叫驅動程式的 EvtIoInCallerContext 回呼函式，如果回呼函式和較高層級的驅動程式都設計為在 IRQL <<= DISPATCH_LEVEL 傳遞要求。

規格需求

另請參閱

EvtDeviceWdmIrpPreprocess