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
Header wudfddi.h (Wudfddi.h を含む)
[DLL] WUDFx.dll

こちらもご覧ください

GetUserModeDriverInitiatedIo

IWDFIoRequest3

WdfRequestSetUserModeDriverInitiatedIo