メディア プレゼンテーションに保護されたメディア パス (PMP) が必要かどうかをクエリします。
構文
HRESULT MFRequireProtectedEnvironment(
[in] IMFPresentationDescriptor *pPresentationDescriptor
);
パラメーター
[in] pPresentationDescriptor
プレゼンテーション記述子の IMFPresentationDescriptor インターフェイスへのポインター。 プレゼンテーション記述子はメディア ソースによって作成され、プレゼンテーションについて説明します。
戻り値
この関数は HRESULT を返します。 使用できる値には、次の表に示す値が含まれますが、これらに限定されません。
| リターン コード | Description |
|---|---|
|
このプレゼンテーションには、保護された環境が必要です。 |
|
このプレゼンテーションでは、保護された環境は必要ありません。 |
注釈
この関数が S_OKを返す場合は、このプレゼンテーションに PMP が必要であることを意味します。 MFCreatePMPMediaSession を呼び出して、PMP セッション オブジェクトを作成します。
関数が S_FALSEを返す場合は、保護されていないパイプラインを使用できます。 MFCreateMediaSession を呼び出して、通常のメディア セッション オブジェクトを作成します。
内部的には、この関数は、プレゼンテーション内のストリーム記述子のいずれかが値 TRUE のMF_SD_PROTECTED属性を持っているかどうかを確認します。
Requirements
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の | ウィンドウズ |
| Header | mfidl.h |
| Library | Mf.lib |
| DLL | Mf.dll |