MF_TOPONODE_NOSHUTDOWN_ON_REMOVE 属性

メディアセッションがトポロジ内のオブジェクトをシャットダウンする方法を指定します。

データ型

UINT32

ブール値として扱います。

この属性は、次の種類のトポロジノードに適用されます。

属性には次の値を指定できます。

値	説明
TRUE	メディアセッションが新しいトポロジに切り替えるか、現在のトポロジをクリアする場合、このトポロジノードに属するオブジェクトはシャットダウンされません。
FALSE	メディアセッションが新しいトポロジに切り替えるか、現在のトポロジをクリアすると、次のようにノードオブジェクトがシャットダウンされます。出力ノード: セッションはメディアシンクで IMFMediaSink::Shutdown を呼び出します。変換ノード: セッションは MFT で IMFShutdown::Shutdown を呼び出します。

値

説明

TRUE

メディアセッションが新しいトポロジに切り替えるか、現在のトポロジをクリアする場合、このトポロジノードに属するオブジェクトはシャットダウンされません。

FALSE

メディアセッションが新しいトポロジに切り替えるか、現在のトポロジをクリアすると、次のようにノードオブジェクトがシャットダウンされます。

既定値は TRUE です。

アプリケーションが複数のトポロジをキューに入れる場合は、この属性を FALSE に設定することをお勧めします。そうでない場合、トポロジ内のオブジェクトが正しくシャットダウンされない可能性があります。

この属性は、アプリケーションが IMFMediaSession::Shutdown を呼び出してメディアセッションをシャットダウンする場合には適用されません。メディアセッションがシャットダウンされると、現在のトポロジ内のメディアシンクと非同期 MFT が常にシャットダウンされます。

この属性の GUID 定数は mfuuid.lib からエクスポートされます。