EVT_WDF_IO_QUEUE_IO_READ回调函数 (wdfio.h)
[适用于 KMDF 和 UMDF]
驱动程序的 EvtIoRead 事件回调函数处理指定的读取请求。
语法
EVT_WDF_IO_QUEUE_IO_READ EvtWdfIoQueueIoRead;
void EvtWdfIoQueueIoRead(
[in] WDFQUEUE Queue,
[in] WDFREQUEST Request,
[in] size_t Length
)
{...}
参数
[in] Queue
与 I/O 请求关联的框架队列对象的句柄。
[in] Request
框架请求对象的句柄。
[in] Length
要读取的字节数。
返回值
无
备注
驱动程序在调用 WdfIoQueueCreate 时注册 EvtIoRead 回调函数。 有关调用 WdfIoQueueCreate 的详细信息，请参阅 创建 I/O 队列。
如果驱动程序为设备的 I/O 队列注册了 EvtIoRead 回调函数，则回调函数将从队列接收每个读取请求。 有关详细信息，请参阅 请求处理程序。
EvtIoRead 回调函数必须以某种方式处理收到的每个 I/O 请求。 有关详细信息，请参阅 处理 I/O 请求。
读取请求需要输出缓冲区，该缓冲区接收驱动程序提供的数据。 有关驱动程序如何访问读取请求的缓冲区的信息，请参阅 访问 Framework-Based 驱动程序中的数据缓冲区。
可以在 IRQL <= DISPATCH_LEVEL调用此回调函数，除非设备或驱动程序WDF_OBJECT_ATTRIBUTES结构的 ExecutionLevel 成员设置为 WdfExecutionLevelPassive。
如果 IRQL 是PASSIVE_LEVEL，框架会在 关键区域内调用回调函数。
有关请求处理程序的 IRQL 级别的详细信息，请参阅 使用自动同步。
驱动程序的 EvtIoRead 回调函数不应调用以下队列对象方法：
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 通用 |
| 最低 KMDF 版本 | 1.0 |
| 最低 UMDF 版本 | 2.0 |
| 标头 | wdfio.h (包括 Wdf.h) |
| IRQL | <= DISPATCH_LEVEL (请参阅备注部分) |