MFCreatePMPMediaSession-Funktion (mfidl.h)

Artikel
08/24/2023

Erstellt eine instance der Mediensitzung innerhalb eines PMP-Prozesses (Protected Media Path).

Syntax

HRESULT MFCreatePMPMediaSession(
  DWORD           dwCreationFlags,
  IMFAttributes   *pConfiguration,
  IMFMediaSession **ppMediaSession,
  IMFActivate     **ppEnablerActivate
);

Parameter

dwCreationFlags

Ein Member der MFPMPSESSION_CREATION_FLAGS-Enumeration , das angibt, wie das Sitzungsobjekt erstellt werden soll.

pConfiguration

Ein Zeiger auf die IMFAttributes-Schnittstelle . Dieser Parameter kann NULL sein. Siehe Hinweise.

ppMediaSession

Empfängt einen Zeiger auf die IMFMediaSession-Schnittstelle der PMP-Mediensitzung. Der Aufrufer muss die Schnittstelle freigeben. Bevor der letzte Verweis auf den IMFMediaSession-Zeiger freigegeben wird, muss die Anwendung die IMFMediaSession::Shutdown-Methode aufrufen.

ppEnablerActivate

Empfängt einen Zeiger auf die IMFActivate-Schnittstelle oder den Wert NULL. Wenn kein NULL-Wert besteht, muss der Aufrufer die Schnittstelle freigeben. Siehe Hinweise.

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	Die Funktion wurde erfolgreich ausgeführt.

Hinweise

Sie können den pConfiguration-Parameter verwenden, um eines der folgenden Attribute festzulegen:

Wenn diese Funktion die PMP-Mediensitzung nicht erstellen kann, weil eine vertrauenswürdige Binärdatei widerrufen wurde, empfängt der ppEnablerActivate-Parameter einen IMFActivate-Schnittstellenzeiger . Die Anwendung kann diesen Zeiger verwenden, um ein Content Enabler-Objekt zu erstellen, das dann zum Herunterladen einer aktualisierten Binärdatei verwendet werden kann:

Rufen Sie IMFActivate::ActivateObject mit dem Schnittstellenbezeichner IID_IMFContentEnabler auf, um einen IMFContentEnabler-Schnittstellenzeiger abzurufen.
Verwenden Sie diese Schnittstelle, um die aktualisierte Binärdatei herunterzuladen.
Rufen Sie MFCreatePMPMediaSession erneut auf.

Wenn die Funktion die PMP-Mediensitzung erfolgreich erstellt, empfängt der ppEnablerActivate-Parameter den Wert NULL.

Führen Sie keine Aufrufe an die PMP-Mediensitzung von einem Thread aus, der eine von einem anderen Thread gesendete Fensternachricht verarbeitet. Um zu testen, ob der aktuelle Thread in diese Kategorie fällt, rufen Sie InSendMessage auf.

Anforderungen

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

Weitere Informationen

MFCreateMediaSession

Media Foundation-Funktionen

PMP-Mediensitzung

Pfad für geschützte Medien

Freigeben über