EVT_WDF_IO_QUEUE_IO_WRITE función de devolución de llamada (wdfio.h)

[Se aplica a KMDF y UMDF]

La función de devolución de llamada de eventos EvtIoWrite de un controlador procesa una solicitud de escritura especificada.

Sintaxis

EVT_WDF_IO_QUEUE_IO_WRITE EvtWdfIoQueueIoWrite;

void EvtWdfIoQueueIoWrite(
  [in] WDFQUEUE Queue,
  [in] WDFREQUEST Request,
  [in] size_t Length
)
{...}

Parámetros

[in] Queue

Identificador del objeto de cola del marco asociado a la solicitud de E/S.

[in] Request

Identificador de un objeto de solicitud de marco.

[in] Length

Número de bytes que se escribirán.

Valor devuelto

None

Observaciones

Un controlador registra una función de devolución de llamada EvtIoWrite cuando llama a WdfIoQueueCreate. Para obtener más información sobre cómo llamar a WdfIoQueueCreate, vea Crear colas de E/S.

Si un controlador ha registrado una función de devolución de llamada EvtIoWrite para la cola de E/S de un dispositivo, la función de devolución de llamada recibe cada solicitud de escritura de la cola. Para obtener más información, consulte Controladores de solicitudes.

La función de devolución de llamada EvtIoWrite debe procesar cada solicitud de E/S recibida de alguna manera. Para obtener más información, consulte Procesamiento de solicitudes de E/S.

Las solicitudes de escritura requieren un búfer de entrada, que contiene los datos que recibe el controlador. Para obtener información sobre cómo el controlador puede acceder al búfer de una solicitud de escritura, consulte Acceso a los búferes de datos en Framework-Based controladores.

Se puede llamar a esta función de devolución de llamada en IRQL <= DISPATCH_LEVEL, a menos que el miembro ExecutionLevel de la estructura de WDF_OBJECT_ATTRIBUTES del dispositivo o del controlador esté establecido en WdfExecutionLevelPassive.

Si irQL está PASSIVE_LEVEL, el marco llama a la función de devolución de llamada dentro de una región crítica.

Para obtener más información sobre los niveles irQL para los controladores de solicitudes, consulte Uso de la sincronización automática.

La función de devolución de llamada EvtIoWrite de un controlador no debe llamar a los siguientes métodos de objeto de cola:

WdfIoQueueDrainSynchronously

WdfIoQueuePurgeSynchronously

WdfIoQueueStopSynchronously

Requisitos

Consulte también

EvtIoDefault

WDF_OBJECT_ATTRIBUTES

WdfIoQueueCreate