IMFActivate::ShutdownObject メソッド (mfobjects.h)
作成したオブジェクトをシャットダウンします。
構文
HRESULT ShutdownObject();
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
注釈
IMFActivate::ActivateObject を呼び出してオブジェクトを作成する場合は、オブジェクトの使用が完了したときに ShutdownObject を呼び出します。
アクティブ化オブジェクトを作成するコンポーネントではなく ActivateObject を呼び出すコンポーネントは、 ShutdownObject を呼び出す役割を担います。 たとえば、一般的な再生アプリケーションでは、アプリケーションはメディア シンクのアクティブ化オブジェクトを作成しますが、メディア セッションは ActivateObject を呼び出します。 そのため、アプリケーションではなくメディア セッションは ShutdownObject を呼び出します。
ShutdownObject が呼び出されると、アクティブ化オブジェクトは、作成されたオブジェクトへの内部参照をすべて解放します。 ActivateObject を再度呼び出すと、アクティブ化オブジェクトによってもう一方のオブジェクトの新しいインスタンスが作成されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mfobjects.h |
| Library | Mfuuid.lib |