IWDFIoRequest3::SetUserModeDriverInitiatedIo 方法 (wudfddi.h)
[警告: UMDF 2 是最新版的 UMDF,並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1,而且較新版本的 Windows 10 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱使用 UMDF 使用者入門。]
SetUserModeDriverInitiatedIo 方法
表示位於相同裝置堆疊中 UMDF 驅動程式下方的核心模式驅動程式,特定要求應該視為來自 UMDF 驅動程式。
語法
void SetUserModeDriverInitiatedIo(
[in] BOOL IsUserModeDriverInitiated
);
參數
[in] IsUserModeDriverInitiated
布爾值,如果為 TRUE,表示要求應該視為 UMDF 驅動程式起始的要求。 如果 為 FALSE,此參數表示要求應該視為來自應用程式。
傳回值
無
備註
如果 UMDF 驅動程式使用 IsUserModeDriverInitiated 參數設為 TRUE 呼叫這個方法,架構會在 WDM IRP 結構的 Flags 成員中設定IRP_UM_DRIVER_INITIATED_IO旗標,再將要求轉送至內核模式驅動程式。
位於相同裝置堆疊中 UMDF 驅動程式下方的核心模式驅動程式可以檢查此旗標,以判斷要求是否應該視為由 UMDF 驅動程式起始。
此旗標不適用於可能透過檔案句柄 I/O 目標或 Win32 I/O 目標從 UMDF 驅動程式接收要求的核心模式驅動程式。
如果驅動程式已驗證要求,UMDF 驅動程式可能會針對來自應用程式的要求,將 IsUserModeDriverInitiated 參數設定為 TRUE 。
要求驅動程式本身所建立的要求已經標示為源自 UMDF 驅動程式。
這個方法的 UMDF 2 對等專案是 WdfRequestSetUserModeDriverInitiatedIo。
規格需求
需求 | 值 |
---|---|
終止支援 | UMDF 2.0 和更新版本中無法使用。 |
目標平台 | 桌面 |
最低UMDF版本 | 1.11 |
標頭 | wudfddi.h (包括 Wudfddi.h) |
Dll | WUDFx.dll |