IWDFRemoteTarget::Stop 方法 (wudfddi.h)
[警告: UMDF 2 是最新版本的 UMDF,取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 未向 UMDF 1 添加新功能,并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅使用 UMDF 入门。]
Stop 方法暂时停止远程 I/O 目标。
语法
HRESULT Stop(
[in] WDF_IO_TARGET_SENT_IO_ACTION Action
);
参数
[in] Action
一个WDF_IO_TARGET_SENT_IO_ACTION类型的值,该值指定框架应如何处理驱动程序已发送到远程 I/O 目标的 I/O 请求(如果目标尚未完成请求)。
返回值
Stop 始终返回S_OK。
注解
如果驱动程序可以在远程 I/O 目标上检测到可恢复的错误,你可能希望驱动程序调用 Stop 以暂时停止发送请求,然后调用 IWDFRemoteTarget::Start 以继续发送请求。
有关 停止以及如何在基于 UMDF 的驱动程序中使用远程 I/O 目标的详细信息,请参阅 在 UMDF 中控制常规 I/O 目标的状态。
示例
下面的代码示例停止远程 I/O 目标。
RemoteTarget->Stop();
要求
要求 | 值 |
---|---|
结束支持 | 在 UMDF 2.0 及更高版本中不可用。 |
目标平台 | 桌面 |
最低 UMDF 版本 | 1.9 |
标头 | wudfddi.h (包括 Wudfddi.h) |
DLL | WUDFx.dll |