WdfIoQueueStopAndPurgeSynchronously 函数 (wdfio.h)

[适用于 KMDF 和 UMDF]

WdfIoQueueStopAndPurgeSynchronously 方法可防止 I/O 队列传送新的 I/O 请求,并导致框架取消现有的未处理请求和驱动程序拥有的可取消请求,但队列接收和存储新请求。

语法

void WdfIoQueueStopAndPurgeSynchronously(
  [in] WDFQUEUE Queue
);

参数

[in] Queue

框架队列对象的句柄。

返回值

没有

注解

此方法返回完成或取消所有未处理的请求和驱动程序拥有的请求(不包括在此调用后添加到队列的请求)。 如果在 WdfIoQueueStopAndPurgeSynchronously 时插入新请求,则在驱动程序调用 WdfIoQueueStart之前,不会传递这些新请求。

如果驱动程序提供无效的对象句柄,则会发生 bug 检查。

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.11
最低 UMDF 版本 2.0
标头 wdfio.h (包括 Wdf.h)
图书馆 Wdf01000.sys(KMDF):WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
DDI 符合性规则 ChangeQueueState(kmdf)DriverCreate(kmdf)EvtSurpriseRemoveNoSuspendQueue(kmdf)NoCancelFromEvtSurpriseRemove(kmdf)

另请参阅

WdfIoQueueStopAndPurge