IWDFObject：：RetrieveContext 方法 (wudfddi.h)

  • 项目

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

RetrieveContext 方法检索以前通过 IWDFObject：：AssignContext 方法注册的上下文。

语法

HRESULT RetrieveContext(
  [out] void **ppvContext
);

参数

[out] ppvContext

指向缓冲区的指针，该缓冲区接收指向以前注册的上下文的指针。

返回值

如果操作成功，RetrieveContext 将返回S_OK。 否则，此方法返回 Winerror.h 中定义的错误代码之一。

注解

由于上下文不是 COM) 接口 (组件对象模型，因此驱动程序不得将上下文视为此类上下文。 例如，驱动程序无法对上下文调用 AddRef 方法。

示例

有关如何使用 RetrieveContext 方法的代码示例，请参阅 IWDFIoQueue：：GetDevice。

要求

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

另请参阅

IWDFIoQueue：：GetDevice

IWDFObject

IWDFObject：：AssignContext