MFCreateAudioRendererActivate-Funktion (mfidl.h)

Erstellt ein Aktivierungsobjekt für den Streamingaudio-Renderer.

Syntax

HRESULT MFCreateAudioRendererActivate(
  [out] IMFActivate **ppActivate
);

Parameter

[out] ppActivate

Empfängt einen Zeiger auf die IMFActivate-Schnittstelle . Verwenden Sie diese Schnittstelle, um den Audiorenderer zu erstellen. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

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

Hinweise

Um den Audiorenderer zu erstellen, rufen Sie IMFActivate::ActivateObject für den abgerufenen IMFActivate-Zeiger auf.

Hinweis Um einen Speicherverlust zu vermeiden, rufen Sie IMFActivate::ShutdownObject auf, bevor Sie den endgültigen Verweis auf den Audiorenderer oder das Audiorenderer-Activate-Objekt freigeben.

 

Legen Sie zum Konfigurieren des Audiorenderers eines der folgenden Attribute für das IMFActivate-Objekt fest, bevor Sie ActivateObject aufrufen. (Wenn Sie die Mediensitzung verwenden, ruft die Mediensitzung automatisch ActivateObject auf , wenn Sie die Topologie in die Warteschlange stellen.)

attribute	BESCHREIBUNG
MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID	Der Gerätebezeichner des Audioendpunkts.
MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ROLE	Die Audioendpunktrolle.
MF_AUDIO_RENDERER_ATTRIBUTE_FLAGS	Verschiedene Konfigurationsflags.
MF_AUDIO_RENDERER_ATTRIBUTE_SESSION_ID	Die Audiorichtlinienklasse.
MF_AUDIO_RENDERER_ATTRIBUTE_STREAM_CATEGORY	Die Audiostreamkategorie.
MF_LOW_LATENCY	Ermöglicht Audiostreaming mit geringer Latenz.

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

Aktivierungsobjekte

Media Foundation-Funktionen

Streaming-Audiorenderer