MFCreatePMPMediaSession 函数 (mfidl.h)

在受保护的媒体路径 (PMP) 进程中创建媒体 会话 的实例。

语法

HRESULT MFCreatePMPMediaSession(
  DWORD           dwCreationFlags,
  IMFAttributes   *pConfiguration,
  IMFMediaSession **ppMediaSession,
  IMFActivate     **ppEnablerActivate
);

参数

dwCreationFlags

指定如何创建会话对象的 MFPMPSESSION_CREATION_FLAGS 枚举的成员。

pConfiguration

指向 IMFAttributes 接口的 指针。 此参数可以为 NULL。 请参阅“备注”。

ppMediaSession

接收指向 PMP 媒体会话的 IMFMediaSession 接口的 指针。 调用方必须释放接口。 在释放对 IMFMediaSession 指针的最后一个引用之前，应用程序必须调用 IMFMediaSession：：Shutdown 方法。

ppEnablerActivate

接收指向 IMFActivate 接口或值 NULL 的指针。 如果不是 NULL，则调用方必须释放接口。 请参阅“备注”。

返回值

函数返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码	说明
S_OK	函数成功。

注解

可以使用 pConfiguration 参数设置以下任何属性：

• MF_SESSION_CONTENT_PROTECTION_MANAGER
• MF_SESSION_GLOBAL_TIME
• MF_SESSION_QUALITY_MANAGER
• MF_SESSION_REMOTE_SOURCE_MODE
• MF_SESSION_SERVER_CONTEXT
• MF_SESSION_TOPOLOADER

如果此函数由于吊销了受信任的二进制文件而无法创建 PMP 媒体会话， 则 ppEnablerActivate 参数将接收 IMFActivate 接口指针。 应用程序可以使用此指针创建内容启用程序对象，该对象随后可用于下载更新的二进制文件：

1. 使用接口标识符IID_IMFContentEnabler调用 IMFActivate：：ActivateObject 以获取 IMFContentEnabler 接口指针。
2. 使用该接口下载更新后的二进制文件。
3. 再次调用 MFCreatePMPMediaSession 。

如果函数成功创建 PMP 媒体会话， 则 ppEnablerActivate 参数将接收值 NULL。

不要从正在处理从另一个线程发送的窗口消息的线程调用 PMP 媒体会话。 若要测试当前线程是否属于此类别，请调用 InSendMessage。

要求

要求	值
最低受支持的客户端	Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器	Windows Server 2008 [桌面应用 | UWP 应用]
目标平台	Windows
标头	mfidl.h
Library	Mf.lib
DLL	Mf.dll

另请参阅

MFCreateMediaSession

媒体基础函数

PMP 媒体会话

受保护的媒体路径