WDF_REQUEST_TYPE列舉 (wudfddi_types.h)

發行項
03/05/2024

[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。所有新的UMDF驅動程式都應該使用UMDF 2撰寫。未將新功能新增至 UMDF 1，且較新版本的 #D7E3C58AB309F4B4EA6FA98006FFECC05 上，UMDF 1 的支援有限。通用 Windows 驅動程式必須使用 UMDF 2。如需詳細資訊，請參閱使用 UMDF 使用者入門。]

WDF_REQUEST_TYPE列舉會識別UMDF要求物件可以表示的I/O要求類型。

Syntax

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` 超過列舉的最大值。