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.
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.)
| Attribute | Description |
|---|---|
| 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 |
|
|
Library |
|
|
DLL |
|
See also