WDF_REQUEST_TYPE列挙 (wudfddi_types.h)

[アーティクル]
08/08/2023

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

WDF_REQUEST_TYPE列挙は、UMDF 要求オブジェクトが表すことができる I/O 要求の種類を識別します。

構文

typedef enum _WDF_REQUEST_TYPE {
  WdfRequestUndefined,
  WdfRequestCreate,
  WdfRequestCleanup,
  WdfRequestRead,
  WdfRequestWrite,
  WdfRequestDeviceIoControl,
  WdfRequestClose,
  WdfRequestUsb,
  WdfRequestOther,
  WdfRequestInternalIoctl,
  WdfRequestTypeNoFormat,
  WdfRequestFlushBuffers,
  WdfRequestQueryInformation,
  WdfRequestSetInformation,
  WdfRequestMaximum
} WDF_REQUEST_TYPE, *PWDF_REQUEST_TYPE;

定数


`WdfRequestUndefined` 要求オブジェクトの型は未定義です。
`WdfRequestCreate` request オブジェクトは、ファイル作成要求を表します。ドライバーは、アプリケーションが Microsoft Win32 CreateFile 関数を呼び出してデバイスを開いたときに、この種類の要求オブジェクトを受け取ります。フレームワークは、新しく作成されたファイルオブジェクト (IWDFFile) と共に、この種類の要求をドライバーの IQueueCallbackCreate::OnCreateFile コールバック関数に配信します。新しいファイルオブジェクトは、Win32 CreateFile から返される HANDLE 型のファイルハンドルを表します。
`WdfRequestCleanup` request オブジェクトは、ファイルクリーンアップ要求を表します。ドライバーは、Win32 CloseHandle 関数へのアプリケーションの呼び出しがファイルオブジェクトへの最後のハンドルを閉じるが、場合によってはファイルのすべての未処理の I/O 要求が完了または取り消される前に、この種類の要求オブジェクトを受け取ります。フレームワークは、ドライバーの IFileCallbackCleanup::OnCleanupFile コールバック関数にこの種類の要求を配信します。 ( WdfRequestClose も参照してください)。
`WdfRequestRead` request オブジェクトは、読み取り要求を表します。このドライバーは、アプリケーションが Win32 ReadFile または ReadFileEx 関数を呼び出すときに、この種類の I/O 要求を受け取ります。フレームワークは、ドライバーの IQueueCallbackRead::OnRead コールバック関数にこの種類の要求を配信します。
`WdfRequestWrite` request オブジェクトは、書き込み要求を表します。このドライバーは、アプリケーションが Win32 WriteFile または WriteFileEx 関数を呼び出すときに、この種類の I/O 要求を受け取ります。フレームワークは、この種類の要求をドライバーの IQueueCallbackWrite::OnWrite コールバック関数に配信します。
`WdfRequestDeviceIoControl` 要求オブジェクトは、デバイス I/O 制御要求を表します。このドライバーは、アプリケーションが Win32 DeviceIoControl 関数を呼び出すときに、この種類の I/O 要求を受け取ります。フレームワークは、ドライバーの IQueueCallbackDeviceIoControl::OnDeviceIoControl コールバック関数にこの種類の要求を配信します。
`WdfRequestClose` request オブジェクトは、ファイルクローズ要求を表します。ドライバーは、Win32 CloseHandle 関数へのアプリケーションの呼び出しがファイルオブジェクトへの最後のハンドルを閉じ、ファイルのすべての未処理の I/O 要求が完了または取り消された後に、この種類の要求オブジェクトを受け取ります。フレームワークは、ドライバーの IFileCallbackClose::OnCloseFile コールバック関数にこの種類の要求を配信します。 ( WdfRequestCleanup も参照してください)。
`WdfRequestUsb` 要求オブジェクトが USB ポートに送信されました。 IWDFRequestCompletionParams::GetCompletedRequestType メソッドは、この値を返すことができます。
`WdfRequestOther` この値は、内部使用専用に予約されています。
`WdfRequestInternalIoctl` この値は、内部使用専用に予約されています。
`WdfRequestTypeNoFormat` 要求オブジェクトの型が指定されていません。
`WdfRequestFlushBuffers` request オブジェクトは、キャッシュされたバッファーをフラッシュする要求を表します。フレームワークは、ドライバーの IQueueCallbackDefaultIoHandler::OnDefaultIoHandler コールバック関数にこの種類の要求を配信します。
`WdfRequestQueryInformation` request オブジェクトは、ファイルに関する情報を取得する要求を表します。フレームワークは、ドライバーの IQueueCallbackDefaultIoHandler::OnDefaultIoHandler コールバック関数にこの種類の要求を配信します。
`WdfRequestSetInformation` request オブジェクトは、ファイルに関する情報を設定する要求を表します。フレームワークは、ドライバーの IQueueCallbackDefaultIoHandler::OnDefaultIoHandler コールバック関数にこの種類の要求を配信します。
`WdfRequestMaximum` 列挙体の最大値を超えています。