Método IQueueCallbackRead::OnRead (wudfddi.h)

Artículo
02/27/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.

Se llama al método OnRead para controlar una solicitud de lectura cuando una aplicación lee información de un dispositivo a través de la función ReadFile o ReadFileEx de Microsoft Win32.

Sintaxis

void OnRead(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToRead
);

Parámetros

[in] pWdfQueue

Puntero a la interfaz IWDFIoQueue del objeto de cola de E/S desde el que llega la solicitud.

[in] pWdfRequest

Puntero a la interfaz IWDFIoRequest que representa el objeto de solicitud de marco.

[in] NumOfBytesToRead

Tamaño, en bytes, del búfer de lectura de la solicitud.

Valor devuelto

None

Observaciones

Un controlador registra la interfaz IQueueCallbackRead cuando el controlador llama al método IWDFDevice::CreateIoQueue para crear una cola de E/S o para configurar la cola de E/S predeterminada.

Un controlador puede implementar un único método OnRead para todas las colas de E/S o métodos OnRead independientes para cada cola de E/S.

El método OnRead recibe cada tipo de solicitud de lectura de la cola. (El tipo de solicitud de lectura se identifica mediante el valor WdfRequestRead del tipo de enumeración WDF_REQUEST_TYPE para la solicitud). El método OnRead debe procesar cada solicitud de lectura recibida. Para obtener más información sobre cómo los controladores de UMDF procesan las solicitudes de E/S, consulte Procesamiento de solicitudes de E/S.

El controlador puede llamar a los métodos IWDFIoRequest::GetReadParameters e IWDFIoRequest::GetOutputMemory para recuperar información sobre la solicitud y el búfer de lectura.