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
程式庫	Mfuuid.lib

另請參閱

啟用物件

IMFActivate