Freigeben über


MFRequireProtectedEnvironment-Funktion (mfidl.h)

Fragt ab, ob für eine Medienpräsentation der geschützte Medienpfad (Protected Media Path, PMP) erforderlich ist.

Syntax

HRESULT MFRequireProtectedEnvironment(
  [in] IMFPresentationDescriptor *pPresentationDescriptor
);

Die Parameter

[in] pPresentationDescriptor

Zeiger auf die IMFPresentationDescriptor-Schnittstelle eines Präsentationsdeskriptors. Der Präsentationsdeskriptor wird von der Medienquelle erstellt und beschreibt die Präsentation.

Rückgabewert

Die Funktion gibt ein HRESULT zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Rückgabecode Description
S_OK
Für diese Präsentation ist eine geschützte Umgebung erforderlich.
S_FALSE
Für diese Präsentation ist keine geschützte Umgebung erforderlich.

Bemerkungen

Wenn diese Funktion S_OK zurückgibt, bedeutet dies, dass der PMP für diese Präsentation erforderlich ist. Rufen Sie MFCreatePMPMediaSession auf, um das PMP-Sitzungsobjekt zu erstellen.

Wenn die Funktion S_FALSE zurückgibt, können Sie die nicht geschützte Pipeline verwenden. Rufen Sie MFCreateMediaSession auf, um das reguläre Mediensitzungsobjekt zu erstellen.

Intern überprüft diese Funktion, ob einer der Datenstromdeskriptoren in der Präsentation das attribut MF_SD_PROTECTED mit dem Wert TRUE aufweist.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 [Nur Desktop-Apps]
Zielplattform Fenster
Header mfidl.h
Library Mf.lib
DLL Mf.dll

Siehe auch

Media Foundation-Funktionen