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 参数设置以下任何属性:

如果此函数由于吊销了受信任的二进制文件而无法创建 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 媒体会话

受保护的媒体路径