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 属性。