Método IQueueCallbackWrite::OnWrite (wudfddi.h)

Artículo
03/08/2023

[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 OnWrite para controlar una solicitud de escritura cuando una aplicación escribe información en un dispositivo a través de la función WriteFile o WriteFileEx de Microsoft Win32.

Sintaxis

void OnWrite(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToWrite
);

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] NumOfBytesToWrite

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

Valor devuelto

None

Observaciones

Un controlador registra la interfaz IQueueCallbackWrite 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 OnWrite para todas las colas de E/S o métodos OnWrite independientes para cada cola de E/S.

El método OnWrite recibe cada tipo de solicitud de escritura de la cola. (El tipo de solicitud de escritura se identifica mediante el valor WdfRequestWrite del tipo de enumeración WDF_REQUEST_TYPE para la solicitud). El método OnWrite debe procesar cada solicitud de escritura 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::GetWriteParameters e IWDFIoRequest::GetInputMemory para recuperar información sobre la solicitud y el búfer de escritura.