WDF_REQUEST_SEND_OPTIONS_FLAGS列挙 (wudfddi_types.h)

  • [アーティクル]

[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDF を使用したはじめに」を参照してください。

WDF_REQUEST_SEND_OPTIONS_FLAGS列挙型は、ドライバーが IWDFIoRequest::Send を呼び出すときに指定できるフラグを定義します。

構文

typedef enum _WDF_REQUEST_SEND_OPTIONS_FLAGS {
  WDF_REQUEST_SEND_OPTION_TIMEOUT,
  WDF_REQUEST_SEND_OPTION_SYNCHRONOUS,
  WDF_REQUEST_SEND_OPTION_IGNORE_TARGET_STATE,
  WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET,
  WDF_REQUEST_SEND_OPTION_IMPERSONATE_CLIENT,
  WDF_REQUEST_SEND_OPTION_IMPERSONATION_IGNORE_FAILURE
} WDF_REQUEST_SEND_OPTIONS_FLAGS;

定数

 
WDF_REQUEST_SEND_OPTION_TIMEOUT
設定した場合、IWDFIoRequest::Send メソッドの Timeout パラメーターが有効です。
WDF_REQUEST_SEND_OPTION_SYNCHRONOUS
設定されている場合、UMDF は I/O 要求を同期的に送信します。
WDF_REQUEST_SEND_OPTION_IGNORE_TARGET_STATE
設定されている場合、UMDF は I/O ターゲットの状態に関係なく、I/O 要求を I/O ターゲットに送信します。 設定されていない場合、ターゲットが停止した場合、UMDF は要求をキューに入れます。 このフラグを設定すると、ドライバーは、 ドライバーが IWDFIoTargetStateManagement::Stop を呼び出した後、USB パイプをリセットする要求などの要求をデバイスに送信できます。
WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET
設定されている場合、ドライバーは要求を非同期的に送信するため、要求が完了または取り消されたときに通知を受け取る必要はありません。 ドライバーは 、IRequestCallbackRequestCompletion::OnCompletion コールバック関数を設定したり、要求に対 して IWDFIoRequest::Complete を呼び出したりしません。 このフラグの詳細については、次の「解説」セクションを参照してください。
WDF_REQUEST_SEND_OPTION_IMPERSONATE_CLIENT
I/O 要求の種類が WdfRequestCreate に設定されている場合、 Send メソッドはクライアントの 偽装 レベルをドライバーの I/O ターゲットに渡そうとします。 この値は、UMDF バージョン 1.9 以降で使用できます。
WDF_REQUEST_SEND_OPTION_IMPERSONATION_IGNORE_FAILURE
設定されている場合、UMDF は偽装エラーを無視します。 この値は、WDF_REQUEST_SEND_OPTION_IMPERSONATE_CLIENTでのみ使用できます。 この値は、UMDF バージョン 1.9 以降で使用できます。

注釈

通常、WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET フラグを設定するドライバーは、 IWDFIoRequest::Send を呼び出して I/O ターゲットに要求を送信する前に I/O 要求を書式設定しません。 実際、このフラグを設定するドライバーは、IWDFIoRequest::Send を呼び出す前に、IWdfIoTarget::FormatRequestForXxx メソッドを呼び出す必要があります。 ドライバーは、 IWDFIoRequest::FormatUsingCurrentType メソッドのみを使用して要求を書式設定できます。

IWDFIoRequest::Send の pIoTarget パラメーターがファイル ハンドル ベースの I/O ターゲット オブジェクトを指している場合、ドライバーは WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET フラグを設定できません。 この種類の I/O ターゲットの詳細については、「 UMDF での一般的な I/O ターゲットの初期化」を参照してください。

ドライバーがWDF_REQUEST_SEND_OPTION_SEND_AND_FORGET フラグを設定する場合、WDF_REQUEST_SEND_OPTION_IMPERSONATE_CLIENTとWDF_REQUEST_SEND_OPTION_IMPERSONATION_IGNORE_FAILURE以外の他のフラグを設定することはできません。

クライアントの偽装の詳細については、「クライアント偽装の 処理」を参照してください。

この列挙体の KMDF バージョンについては、「 WDF_REQUEST_SEND_OPTIONS_FLAGS」を参照してください。

要件

要件 値
最小 UMDF バージョン 1.0
Header wudfddi_types.h (Wudfddi.h を含む)

こちらもご覧ください

IWDFIoRequest::Send