IMFActivate::ShutdownObject メソッド (mfobjects.h)

  • [アーティクル]

作成したオブジェクトをシャットダウンします。

構文

HRESULT ShutdownObject();

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 メソッドが成功しました。

注釈

IMFActivate::ActivateObject を呼び出してオブジェクトを作成する場合は、オブジェクトの使用が完了したときに ShutdownObject を呼び出します。

アクティブ化オブジェクトを作成するコンポーネントではなく ActivateObject を呼び出すコンポーネントは、 ShutdownObject を呼び出す役割を担います。 たとえば、一般的な再生アプリケーションでは、アプリケーションはメディア シンクのアクティブ化オブジェクトを作成しますが、メディア セッションは ActivateObject を呼び出します。 そのため、アプリケーションではなくメディア セッションは ShutdownObject を呼び出します。

ShutdownObject が呼び出されると、アクティブ化オブジェクトは、作成されたオブジェクトへの内部参照をすべて解放します。 ActivateObject を再度呼び出すと、アクティブ化オブジェクトによってもう一方のオブジェクトの新しいインスタンスが作成されます。

要件

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

こちらもご覧ください

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

IMFActivate