Export (0) Print
Expand All
Expand Minimize

MFCreateAudioRendererActivate function

Creates an activation object for the Streaming Audio Renderer.

Syntax


HRESULT MFCreateAudioRendererActivate(
  _Out_  IMFActivate **ppActivate
);

Parameters

ppActivate [out]

Receives a pointer to the IMFActivate interface. Use this interface to create the audio renderer. The caller must release the interface.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

To create the audio renderer, call IMFActivate::ActivateObject on the retrieved IMFActivate pointer.

Note  To avoid a memory leak, call IMFActivate::ShutdownObject before releasing the final reference to the audio renderer or the audio renderer activate object.

To configure the audio renderer, set any of the following attributes on the IMFActivate object before calling ActivateObject. (If you are using the Media Session, the Media Session automatically calls ActivateObject when you queue the topology.)

AttributeDescription
MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID The audio endpoint device identifier.
MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ROLE The audio endpoint role.
MF_AUDIO_RENDERER_ATTRIBUTE_FLAGS Miscellaneous configuration flags.
MF_AUDIO_RENDERER_ATTRIBUTE_SESSION_ID The audio policy class.
MF_AUDIO_RENDERER_ATTRIBUTE_STREAM_CATEGORY The audio stream category.
MF_LOW_LATENCY Enables low-latency audio streaming.

 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Mfidl.h

Library

Mf.lib

DLL

Mf.dll

See also

Media Foundation Functions
Activation Objects
Streaming Audio Renderer

 

 

Community Additions

ADD
Show:
© 2014 Microsoft