Freigeben über

MFCreateAudioRendererActivate-Funktion (mfidl.h)

  • Artikel

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