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 ，或
• 调用特定于对象的关闭方法。 此方法将取决于对象的类型。 可能的情况包括：
  • 媒体来源：呼叫 IMFMediaSource：：Shutdown。
  • 媒体接收器：调用 IMFMediaSink：：Shutdown。
  • 支持 IMFShutdown 接口的任何对象：调用 IMFShutdown：：Shutdown。

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

首次调用 ActivateObject 后，后续调用将返回指向同一实例的指针，直到客户端调用 ShutdownObject 或 IMFActivate：:D etachObject。

要求

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

另请参阅

激活对象

IMFActivate