IMFActivate::ActivateObject 方法 (mfobjects.h)

创建与此激活对象关联的 对象。

语法

HRESULT ActivateObject(
  [in]  REFIID riid,
  [out] void   **ppv
);

参数

[in] riid

接口标识符 (所请求接口的 IID) 。

[out] ppv

接收指向所请求接口的指针。 调用方必须释放接口。

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

某些 Microsoft Media Foundation 对象在发布之前必须关闭。 如果是这样,调用方负责关闭 在 ppv 中返回的对象。 若要关闭对象,请执行下列操作之一:

IMFActivate::ShutdownObject 方法是所有对象类型的通用方法。 如果对象不需要关闭方法, 则 ShutdownObject 成功且不起作用。 如果不知道对象 (的特定关闭方法,或者不知道对象类型) ,请调用 IMFActivate::ShutdownObject

首次调用 ActivateObject 后,后续调用将返回指向同一实例的指针,直到客户端调用 ShutdownObjectIMFActivate::D etachObject

要求

要求
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 mfobjects.h
Library Mfuuid.lib

另请参阅

激活对象

IMFActivate