MFCreateASFStreamingMediaSinkActivate-Funktion (wmcontainer.h)

Artikel
08/28/2023

Erstellt ein Aktivierungsobjekt für die ASF-Streamingsenke.

Die ASF-Streamingsenke ermöglicht es einer Anwendung, Streamingpakete von Advanced Systems Format (ASF) in einen HTTP-Bytestream zu schreiben. Das Aktivierungsobjekt kann verwendet werden, um die ASF-Streamingsenke in einem anderen Prozess zu erstellen.

Syntax

HRESULT MFCreateASFStreamingMediaSinkActivate(
  IMFActivate       *pByteStreamActivate,
  IMFASFContentInfo *pContentInfo,
  IMFActivate       **ppIActivate
);

Parameter

pByteStreamActivate

Ein Zeiger auf die IMFActivate-Schnittstelle eines Aktivierungsobjekts. Der Aufrufer implementiert diese Schnittstelle. Die IMFActivate::ActivateObject-Methode des Aktivierungsobjekts muss ein Bytestreamobjekt erstellen. Der Bytestream macht die IMFByteStream-Schnittstelle verfügbar. Die ASF-Streamingsenke schreibt Daten in diesen Bytedatenstrom.

pContentInfo

Ein Zeiger auf ein ASF ContentInfo-Objekt , das die Eigenschaften enthält, die den ASF-Inhalt beschreiben. Diese Einstellungen können Streameinstellungen, Codierungseigenschaften und Metadaten enthalten. Weitere Informationen zu diesen Eigenschaften finden Sie unter Festlegen von Eigenschaften im ContentInfo-Objekt.

ppIActivate

Empfängt einen Zeiger auf die IMFActivate-Schnittstelle des Aktivierungsobjekts, das zum Erstellen der ASF-Streamingmediensenke verwendet wird. Um die Mediensenke zu erstellen, muss die Anwendung MITHILFE des empfangenen Zeigers IMFActivate::ActivateObject aufrufen. Die ActivateObject-Methode ruft auch IMFActivate::Activate für das von pByteStreamActivate angegebene Bytestream-Activate-Objekt auf, um es zu erstellen, damit die Mediensenke gestreamte Inhalte in den Bytedatenstrom schreiben kann. Der Aufrufer muss den IMFActivate-Schnittstellenzeiger des in ppIActivate empfangenen Mediensenkenaktivierungsobjekts freigeben.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Ab Windows 7 stellt Media Foundation eine ASF-Streamingsenke bereit, die den Inhalt in einem Livestreamingszenario schreibt. Diese Funktion sollte in Szenarien mit sicherer Transcodierung verwendet werden, in denen diese Mediensenke im Remoteprozess erstellt und konfiguriert werden muss. Wie die ASF-Dateisenke führt die neue Mediensenke ASF-bezogene Aufgaben aus, z. B. das Schreiben des ASF-Headers, das Generieren von Datenpaketen (Muxing). Der Inhalt wird in einen vom Aufrufer implementierten Bytestream geschrieben, z. B. in einen HTTP-Bytedatenstrom. Der Aufrufer muss auch ein Aktivierungsobjekt bereitstellen, das die Mediensenke verwenden kann, um den Bytestream remote zu erstellen.

Darüber hinaus führt es die Transcryption zum Streamen geschützter Inhalte durch. Es hostet die Windows Media Digital Rights Management (DRM) for Network Devices Output Trust Authority (OTA), die die Lizenzanforderung und -antwort verarbeitet. Weitere Informationen finden Sie unter IMFDRMNetHelper-Schnittstelle .

Die neue Mediensenke führt keine Zeitanpassungen durch. Wenn die Uhr sucht, werden die Zeitstempel nicht geändert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wmcontainer.h
Bibliothek	Mf.lib
DLL	Mf.dll

Weitere Informationen

MFCreateASFStreamingMediaSink

Media Foundation-Funktionen

Share via