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 を呼び出すか、または
  • オブジェクト固有のシャットダウン メソッドを呼び出します。 このメソッドは、オブジェクトの種類によって異なります。 可能性としては次のとおりです。
IMFActivate::ShutdownObject メソッドは、すべてのオブジェクト型に対してジェネリックです。 オブジェクトにシャットダウン メソッドが必要ない場合、 ShutdownObject は成功し、影響はありません。 オブジェクトの特定のシャットダウン メソッドがわからない (またはオブジェクトの種類がわからない) 場合は、 IMFActivate::ShutdownObject を呼び出します。

ActivateObject の最初の呼び出しの後、以降の呼び出しは、クライアントが ShutdownObject または IMFActivate::D etachObject を呼び出すまで、同じインスタンスへのポインターを返します。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー mfobjects.h
Library Mfuuid.lib

こちらもご覧ください

アクティブ化オブジェクト

IMFActivate