enumeración WDF_REQUEST_TYPE (wudfddi_types.h)

Artículo
03/05/2024

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

La enumeración WDF_REQUEST_TYPE identifica los tipos de solicitudes de E/S que un objeto de solicitud UMDF puede representar.

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;

Constantes


`WdfRequestUndefined` El tipo del objeto de solicitud no está definido.
`WdfRequestCreate` El objeto request representa una solicitud de creación de archivos. El controlador recibe este tipo de objeto de solicitud cuando una aplicación abre un dispositivo llamando a la función CreateFile de Microsoft Win32. El marco entrega este tipo de solicitud, junto con un objeto de archivo recién creado (IWDFFile), a la función de devolución de llamada IQueueCallbackCreate::OnCreateFile del controlador. El nuevo objeto de archivo representa el identificador de archivo con tipo HANDLE que devuelve el archivo CreateFile de Win32.
`WdfRequestCleanup` El objeto request representa una solicitud de limpieza de archivos. El controlador recibe este tipo de objeto de solicitud después de que la llamada de una aplicación a la función CloseHandle de Win32 cierre el último identificador de un objeto de archivo, pero posiblemente antes de que se hayan completado o cancelado todas las solicitudes de E/S pendientes del archivo. El marco entrega este tipo de solicitud a la función de devolución de llamada IFileCallbackCleanup::OnCleanupFile del controlador. (Consulte también WdfRequestClose).
`WdfRequestRead` El objeto request representa una solicitud de lectura. Este controlador recibe este tipo de solicitud de E/S cuando una aplicación llama a la función ReadFile o ReadFileEx de Win32. El marco ofrece este tipo de solicitud a la función de devolución de llamada IQueueCallbackRead::OnRead del controlador.
`WdfRequestWrite` El objeto request representa una solicitud de escritura. Este controlador recibe este tipo de solicitud de E/S cuando una aplicación llama a la función WriteFile o WriteFileEx de Win32. El marco entrega este tipo de solicitud a la función de devolución de llamada IQueueCallbackWrite::OnWrite del controlador.
`WdfRequestDeviceIoControl` El objeto de solicitud representa una solicitud de control de E/S de dispositivo. Este controlador recibe este tipo de solicitud de E/S cuando una aplicación llama a la función DeviceIoControl de Win32. El marco entrega este tipo de solicitud a la función de devolución de llamada IQueueCallbackDeviceIoControl::OnDeviceIoControl del controlador.
`WdfRequestClose` El objeto request representa una solicitud de cierre de archivo. El controlador recibe este tipo de objeto de solicitud después de que la llamada de una aplicación a la función CloseHandle de Win32 cierre el último identificador de un objeto de archivo y después de que se hayan completado o cancelado todas las solicitudes de E/S pendientes del archivo. El marco entrega este tipo de solicitud a la función de devolución de llamada IFileCallbackClose::OnCloseFile del controlador. (Consulte también WdfRequestCleanup).
`WdfRequestUsb` El objeto de solicitud se envió a un puerto USB. El método IWDFRequestCompletionParams::GetCompletedRequestType puede devolver este valor.
`WdfRequestOther` Este valor está reservado solo para uso interno.
`WdfRequestInternalIoctl` Este valor está reservado solo para uso interno.
`WdfRequestTypeNoFormat` No se ha especificado el tipo del objeto de solicitud.
`WdfRequestFlushBuffers` El objeto de solicitud representa una solicitud para vaciar los búferes almacenados en caché. El marco entrega este tipo de solicitud a la función de devolución de llamada IQueueCallbackDefaultIoHandler::OnDefaultIoHandler del controlador.
`WdfRequestQueryInformation` El objeto request representa una solicitud para obtener información sobre un archivo. El marco entrega este tipo de solicitud a la función de devolución de llamada IQueueCallbackDefaultIoHandler::OnDefaultIoHandler del controlador.
`WdfRequestSetInformation` El objeto request representa una solicitud para establecer información sobre un archivo. El marco entrega este tipo de solicitud a la función de devolución de llamada IQueueCallbackDefaultIoHandler::OnDefaultIoHandler del controlador.
`WdfRequestMaximum` Se supera el valor máximo de la enumeración.