EVT_WDF_IO_QUEUE_IO_DEVICE_CONTROL回调函数 (wdfio.h)

项目
02/29/2024

[适用于 KMDF 和 UMDF]

驱动程序的 EvtIoDeviceControl 事件回调函数处理指定的设备 I/O 控制请求。

语法

EVT_WDF_IO_QUEUE_IO_DEVICE_CONTROL EvtWdfIoQueueIoDeviceControl;

void EvtWdfIoQueueIoDeviceControl(
  [in] WDFQUEUE Queue,
  [in] WDFREQUEST Request,
  [in] size_t OutputBufferLength,
  [in] size_t InputBufferLength,
  [in] ULONG IoControlCode
)
{...}

参数

[in] Queue

与 I/O 请求关联的框架队列对象的句柄。

[in] Request

框架请求对象的句柄。

[in] OutputBufferLength

如果输出缓冲区可用，则为请求的输出缓冲区的长度（以字节为单位）。

[in] InputBufferLength

如果输入缓冲区可用，则为请求的输入缓冲区的长度（以字节为单位）。

[in] IoControlCode

驱动程序定义或系统定义的 I/O 控制代码 (与请求关联的 IOCTL) 。

返回值

无

备注

驱动程序在调用 WdfIoQueueCreate 时注册 EvtIoDeviceControl 回调函数。有关调用 WdfIoQueueCreate 的详细信息，请参阅创建 I/O 队列。

如果驱动程序已为设备的 I/O 队列注册了 EvtIoDeviceControl 回调函数，则回调函数将从队列接收每个 I/O 控制请求 (IRP_MJ_DEVICE_CONTROL) 。有关详细信息，请参阅请求处理程序。

EvtIoDeviceControl 回调函数必须以某种方式处理每个收到的 I/O 请求。有关详细信息，请参阅处理 I/O 请求。

当用户应用程序调用 deviceIoControl (文档) Microsoft Windows SDK中所述时，或者当另一个驱动程序通过调用 WdfIoTargetSendIoctlSynchronously 或 WdfIoTargetFormatRequestForIoctl 创建请求时，驱动程序会收到 I/O 控制请求。

要执行的操作类型取决于 IoControlCode 参数的值。必须确定应用程序和其他驱动程序可以发送到驱动程序的 IoControlCode 值集。有关 IOCTL 的详细信息，请参阅使用 I/O 控制代码。

大多数设备 I/O 控制操作都需要输入缓冲区和/或输出缓冲区。有关驱动程序如何访问请求缓冲区的信息，请参阅访问 Framework-Based 驱动程序中的数据缓冲区。

驱动程序可用于访问请求输入和输出缓冲区的技术 (是否存在) 取决于 IOCTL 的 TransferType 字段。 IOCTL 的 TransferType 字段的值可以是METHOD_BUFFERED、METHOD_DIRECT_IN、METHOD_DIRECT_OUT或METHOD_NEITHER。有关 TransferType 字段的详细信息，请参阅定义 I/O 控制代码。

可以在 IRQL <= DISPATCH_LEVEL调用 EvtIoDeviceControl 回调函数，除非设备或驱动程序的WDF_OBJECT_ATTRIBUTES结构的 ExecutionLevel 成员设置为 WdfExecutionLevelPassive。

如果 IRQL PASSIVE_LEVEL，框架会在关键区域内调用回调函数。

有关请求处理程序的 IRQL 级别的详细信息，请参阅使用自动同步。

驱动程序的 EvtIoDeviceControl 回调函数不应调用以下队列对象方法：

WdfIoQueueDrainSynchronously

WdfIoQueuePurgeSynchronously

WdfIoQueueStopSynchronously