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