WDF_REQUEST_TYPE 枚举 (wudfddi_types.h)

项目
03/05/2024

[警告： 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` 请求对象表示文件创建请求。当应用程序通过调用 Microsoft Win32 CreateFile 函数打开设备时，驱动程序会收到这种类型的请求对象。框架将此类请求以及新创建的文件对象 (IWDFFile) 传递到驱动程序的 IQueueCallbackCreate：：OnCreateFile 回调函数。新的文件对象表示 Win32 CreateFile 返回的 HANDLE 类型的文件句柄。
`WdfRequestCleanup` 请求对象表示文件清理请求。在应用程序对 Win32 CloseHandle 函数的调用关闭文件对象的最后一个句柄之后，但可能在文件的所有未完成 I/O 请求完成或取消之前，驱动程序会收到这种类型的请求对象。框架将这种类型的请求传递到驱动程序的 IFileCallbackCleanup：：OnCleanupFile 回调函数。 (另请参阅 WdfRequestClose.)
`WdfRequestRead` 请求对象表示读取请求。当应用程序调用 Win32 ReadFile 或 ReadFileEx 函数时，此驱动程序会收到这种类型的 I/O 请求。框架将此类请求传递到驱动程序的 IQueueCallbackRead：：OnRead 回调函数。
`WdfRequestWrite` 请求对象表示写入请求。当应用程序调用 Win32 WriteFile 或 WriteFileEx 函数时，此驱动程序会收到这种类型的 I/O 请求。框架将这种类型的请求传递到驱动程序的 IQueueCallbackWrite：：OnWrite 回调函数。
`WdfRequestDeviceIoControl` 请求对象表示设备 I/O 控制请求。当应用程序调用 Win32 DeviceIoControl 函数时，此驱动程序会收到这种类型的 I/O 请求。框架将这种类型的请求传递到驱动程序的 IQueueCallbackDeviceIoControl：：OnDeviceIoControl 回调函数。
`WdfRequestClose` 请求对象表示文件关闭请求。在应用程序调用 Win32 CloseHandle 函数关闭文件对象的最后一个句柄后，以及完成或取消文件的所有未完成 I/O 请求后，驱动程序会收到这种类型的请求对象。框架将此类请求传递到驱动程序的 IFileCallbackClose：：OnCloseFile 回调函数。 (另请参阅 WdfRequestCleanup.)
`WdfRequestUsb` 请求对象已发送到 USB 端口。 IWDFRequestCompletionParams：：GetCompletedRequestType 方法可以返回此值。
`WdfRequestOther` 此值仅供内部使用。
`WdfRequestInternalIoctl` 此值仅供内部使用。
`WdfRequestTypeNoFormat` 尚未指定请求对象的类型。
`WdfRequestFlushBuffers` 请求对象表示刷新缓存缓冲区的请求。框架将此类请求传递到驱动程序的 IQueueCallbackDefaultIoHandler：：OnDefaultIoHandler 回调函数。
`WdfRequestQueryInformation` 请求对象表示获取有关文件的信息的请求。框架将此类请求传递到驱动程序的 IQueueCallbackDefaultIoHandler：：OnDefaultIoHandler 回调函数。
`WdfRequestSetInformation` 请求对象表示设置有关文件的信息的请求。框架将此类请求传递到驱动程序的 IQueueCallbackDefaultIoHandler：：OnDefaultIoHandler 回调函数。
`WdfRequestMaximum` 超出枚举的最大值。