MFRequireProtectedEnvironment 函数 (mfidl.h)

查询媒体演示文稿是否需要受保护的媒体路径(PMP)。

Syntax

HRESULT MFRequireProtectedEnvironment(
  [in] IMFPresentationDescriptor *pPresentationDescriptor
);

参数

[in] pPresentationDescriptor

指向演示文稿描述符的 IMFPresentationDescriptor 接口的指针。 演示文稿描述符由媒体源创建,并描述演示文稿。

返回值

该函数返回 HRESULT。 可能的值包括但不限于下表中的值。

返回代码 Description
S_OK
此演示文稿需要受保护的环境。
S_FALSE
此演示文稿不需要受保护的环境。

注解

如果此函数返回 S_OK,则表示此演示文稿需要 PMP。 调用 MFCreatePMPMediaSession 以创建 PMP 会话对象。

如果函数返回 S_FALSE,则可以使用未受保护的管道。 调用 MFCreateMediaSession 以创建常规媒体会话对象。

在内部,此函数检查演示文稿中的任何流描述符是否具有值为 TRUEMF_SD_PROTECTED 属性。

要求

Requirement 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows操作系统
Header mfidl.h
Library Mf.lib
DLL Mf.dll

另请参阅

Media Foundation Functions