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

Artículo
08/08/2023

[Se aplica a KMDF y UMDF]

La función de devolución de llamada de eventos EvtIoDefault de un controlador procesa una solicitud de E/S especificada.

Sintaxis

EVT_WDF_IO_QUEUE_IO_DEFAULT EvtWdfIoQueueIoDefault;

void EvtWdfIoQueueIoDefault(
  [in] WDFQUEUE Queue,
  [in] WDFREQUEST Request
)
{...}

Parámetros

[in] Queue

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

[in] Request

Identificador de un objeto de solicitud de marco.

Valor devuelto

None

Observaciones

Un controlador registra una función de devolución de llamada EvtIoDefault cuando llama a WdfIoQueueCreate. Para obtener más información sobre cómo llamar a WdfIoQueueCreate, vea Creating I/O Queues.

Si un controlador ha registrado una función de devolución de llamada EvtIoDefault para la cola de E/S de un dispositivo, la función de devolución de llamada recibe todas las solicitudes de E/S de la cola, a menos que también se hayan registrado funciones de devolución de llamada específicas de la solicitud. Para obtener más información sobre las funciones de devolución de llamada específicas de la solicitud, consulte Controladores de solicitudes.

La función de devolución de llamada EvtIoDefault de un controlador también puede recibir solicitudes de creación de archivos. Para obtener más información sobre cómo recibir solicitudes de creación de archivos, vea Objetos de archivo de marco.

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

La mayoría de las operaciones de E/S requieren un búfer de entrada, un búfer de salida o ambos. Para obtener información sobre cómo el controlador puede acceder a los búferes de una solicitud, 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 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 de IRQL para los controladores de solicitudes, consulte Uso de la sincronización automática.

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

WdfIoQueueDrainSynchronously

WdfIoQueuePurgeSynchronously

WdfIoQueueStopSynchronously

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	wdfio.h (incluir Wdf.h)
IRQL	<= DISPATCH_LEVEL (consulte la sección Comentarios)