通过

IWDFIoQueue：:D rain 方法 （wudfddi.h）

  • 项目

[警告： UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 没有将新功能添加到 UMDF 1，并且对较新版本的 Windows 10 上的 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅 UMDF入门 。]

Drain 方法指示队列拒绝新的传入 I/O 请求，并允许已排队的请求传递到驱动程序进行处理。

语法

void Drain(
  [in, optional] IQueueCallbackStateChange *pDrainComplete
);

参数

[in, optional] pDrainComplete

指向 IQueueCallbackStateChange 接口的指针，该接口的框架调用将队列状态传送到驱动程序的方法。 框架在完成或取消所有请求后调用该方法，队列为空。 此参数是可选的，可以 NULL。

返回值

没有

言论

驱动程序应确保在任何给定时间只有以下方法之一正在进行：

例如，如果驱动程序之前调用 清空，则它应等待接口方法的通知，pDrainComplete 参数指向驱动程序调用 停止 或 清除。 违反此规则会导致主机进程终止。

要求

要求 价值
终止支持 在 UMDF 2.0 及更高版本中不可用。
目标平台 桌面
最低 UMDF 版本 1.5
标头 wudfddi.h （包括 Wudfddi.h）
DLL WUDFx.dll

另请参阅

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue：:P urge

IWDFIoQueue：：Stop