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 構造体の フラグ メンバーの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

関連項目

GetUserModeDriverInitiatedIo の

IWDFIoRequest3 の

WdfRequestSetUserModeDriverInitiatedIo