EVT_WDF_USB_READERS_FAILED回调函数 (wdfusb.h)

[适用于 KMDF 和 UMDF]

驱动程序的 EvtUsbTargetPipeReadersFailed 事件回调函数通知驱动程序，连续读取器在处理读取请求时报告了错误。

语法

EVT_WDF_USB_READERS_FAILED EvtWdfUsbReadersFailed;

BOOLEAN EvtWdfUsbReadersFailed(
  [in] WDFUSBPIPE Pipe,
  [in] NTSTATUS Status,
  [in] USBD_STATUS UsbdStatus
)
{...}

参数

[in] Pipe

框架管道对象的句柄。

[in] Status

管道的 I/O 目标返回的 NTSTATUS 值 。

[in] UsbdStatus

管道的 I/O 目标返回的 USBD_STATUS类型状态值。

返回值

EvtUsbTargetPipeReadersFailed 事件回调函数返回一个布尔值，如果为 TRUE，则会导致框架重置 USB 管道，然后重启连续读取器。 如果此函数返回 FALSE，则框架不会重置设备或重启连续读取器。

注解

若要注册 EvtUsbTargetPipeReadersFailed 回调函数，驱动程序必须将函数的地址置于 WDF_USB_CONTINUOUS_READER_CONFIG 结构中。 有关何时添加此函数指针的信息，请参阅 WDF_USB_CONTINUOUS_READER_CONFIG_INIT 的“备注”部分。

如果驱动程序已为 USB 管道创建了连续读取器，则如果驱动程序的 I/O 目标在完成读取请求时报告错误，框架将调用驱动程序的 EvtUsbTargetPipeReadersFailed 回调函数。 (如果 I/O 目标成功完成请求，框架将调用驱动程序的 EvtUsbTargetPipeReadComplete 回调函数.)

在框架调用驱动程序的 EvtUsbTargetPipeReadersFailed 回调函数之前，它会尝试取消所有正在进行的读取请求。 当框架调用 EvtUsbTargetPipeReadersFailed 回调函数时，没有读取请求正在进行中。 在 EvtUsbTargetPipeReadersFailed 回调函数返回之前，框架不会将任何其他读取请求排队。

有关框架如何将 对 EvtUsbTargetPipeReadersFailed 回调函数的调用与其他回调函数的调用同步的信息，请参阅 EvtUsbTargetPipeReadComplete 的“备注”部分。

EvtUsbTargetPipeReadersFailed 回调函数不得调用 WdfIoTargetStop 来停止连续读取器的 USB 目标。 (事实上，在 EvtUsbTargetPipeReadersFailed 回调函数中调用 WdfIoTargetStop 会导致死锁。) 此外，回调函数不得调用 WdfIoTargetStart 来重启连续读取器。 相反，如果回调函数返回 TRUE，框架将重启读取器。 有关何时为连续读取器调用 WdfIoTargetStart 和 WdfIoTargetStop 的详细信息，请参阅 使用 USB 管道。

如果驱动程序不提供 EvtUsbTargetPipeReadersFailed 回调函数，并且驱动程序的 I/O 目标报告错误，框架将重置 USB 管道并重启连续读取器。

有关 EvtUsbTargetPipeReadersFailed 回调函数和 USB I/O 目标的详细信息，请参阅 USB I/O 目标。

要求

要求	值
目标平台	通用
最低 KMDF 版本	1.0
最低 UMDF 版本	2.0
标头	wdfusb.h (包括 Wdf.h)
IRQL	PASSIVE_LEVEL

另请参阅

EvtUsbTargetPipeReadComplete

WDF_USB_CONTINUOUS_READER_CONFIG