MFRequireProtectedEnvironment 関数 (mfidl.h)

メディアプレゼンテーションに保護メディアパス (PMP) が必要かどうかを照会します。

構文

HRESULT MFRequireProtectedEnvironment(
  [in] IMFPresentationDescriptor *pPresentationDescriptor
);

[in] pPresentationDescriptor

プレゼンテーション記述子の IMFPresentationDescriptor インターフェイスへのポインター。プレゼンテーション記述子はメディアソースによって作成され、プレゼンテーションについて説明します。

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

リターンコード	説明
S_OK	このプレゼンテーションには、保護された環境が必要です。
S_FALSE	このプレゼンテーションでは、保護された環境は必要ありません。

この関数が S_OKを返す場合は、このプレゼンテーションに PMP が必要であることを意味します。 MFCreatePMPMediaSession を呼び出して、PMP セッションオブジェクトを作成します。

関数が S_FALSEを返す場合は、保護されていないパイプラインを使用できます。 MFCreateMediaSession を呼び出して、通常のメディアセッションオブジェクトを作成します。

内部的には、この関数は、プレゼンテーション内のストリーム記述子のいずれかが値 TRUE の MF_SD_PROTECTED 属性を持っているかどうかを確認 します。