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

[Se aplica a KMDF y UMDF]

La evtIoDefault de un controlador función de devolución de llamada de eventos 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

Ninguno

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 Creación de colas de E/S.

Si un controlador ha registrado una EvtIoDefault función de devolución de llamada 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 solicitud. Para obtener más información sobre las funciones de devolución de llamada específicas de la solicitud, consulte controladores de solicitudes.

Las evtIoDefault de un controlador función de devolución de llamada también pueden recibir solicitudes de creación de archivos. Para obtener más información sobre cómo recibir solicitudes de creación de archivos, vea Framework File Objects.

El EvtIoDefault función de devolución de llamada debe procesar cada solicitud de E/S recibida de alguna manera. Para obtener más información, consulte procesar 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 búferes de datos en controladores de Framework-Based.

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

Si irQL es 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 Using Automatic Synchronization.

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

WdfIoQueueDrainSynchronously

WdfIoQueuePurgeSynchronously

WdfIoQueueStopSynchronously

Requisitos

Consulte también

EvtIoDeviceControl

EvtIoInternalDeviceControl

EvtIoRead

evtIoWrite de

WDF_OBJECT_ATTRIBUTES

WdfIoQueueCreate