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. 使用介面標識符呼叫 IMFActivate：：ActivateObject IID_IMFContentEnabler以取得 IMFContentEnabler 介面指標。
2. 使用該介面來下載更新的二進位檔。
3. 再次呼叫 MFCreatePMPMediaSession 。

如果函式成功建立 PMP 媒體會話， ppEnablerActivate 參數會收到 NULL 值。

請勿從正在處理從另一個線程傳送的視窗訊息的線程呼叫 PMP 媒體會話。 若要測試目前線程是否屬於此類別，請呼叫 InSendMessage。

規格需求

需求	值
最低支援的用戶端	Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	mfidl.h
程式庫	Mf.lib
Dll	Mf.dll

另請參閱

MFCreateMediaSession

媒體基礎函式

PMP 媒體會話

受保護的媒體路徑