WdfRequestSetUserModeDriverInitiatedIo 関数 (wdfrequest.h)
[UMDF にのみ適用]
WdfRequestSetUserModeDriverInitiatedIo メソッドは、同じデバイス スタック内の UMDF ドライバーの下にあるカーネル モード ドライバーに対して、特定の要求を UMDF ドライバーから取得したかのように扱う必要があることを示します。
構文
void WdfRequestSetUserModeDriverInitiatedIo(
[in] WDFREQUEST Request,
[in] BOOLEAN IsUserModeDriverInitiated
);
パラメーター
[in] Request
フレームワーク要求オブジェクトへのハンドル。
[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 ドライバーから送信されたとマークされています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8.1 |
| 対象プラットフォーム | ユニバーサル |
| 最小 UMDF バージョン | 2.0 |
| Header | wdfrequest.h (Wdf.h を含む) |
| Library | WUDFx02000.lib;WUDFx02000.dll |
| IRQL | PASSIVE_LEVEL |