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
);

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ögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	Beschreibung
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.

Hinweise

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 Media Session-Objekt zu erstellen.

Intern überprüft diese Funktion, ob einer der Streamdeskriptoren in der Präsentation über das attribut MF_SD_PROTECTED mit dem Wert TRUE verfügt.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfidl.h
Bibliothek	Mf.lib
DLL	Mf.dll

Weitere Informationen

Media Foundation-Funktionen