Método IQueueCallbackWrite::OnWrite (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante 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 a 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 WriteFileEx de Microsoft Win32 o WriteFileEx.
Sintaxis
void OnWrite(
[in] IWDFIoQueue *pWdfQueue,
[in] IWDFIoRequest *pWdfRequest,
[in] SIZE_T NumOfBytesToWrite
);
Parámetros
[in] pWdfQueue
Puntero al interfaz de IWDFIoQueue para el 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
Ninguno
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 de OnWrite para todas las colas de E/S o métodos de OnWrite 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 WdfRequestWrite valor 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 Procesar solicitudes de E/S.
El controlador puede llamar a los métodos IWDFIoRequest::GetWriteParameters y IWDFIoRequest::GetInputMemory para recuperar información sobre la solicitud y el búfer de escritura.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Windows |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |