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) |