IAudioRenderClient interface (audioclient.h)

The IAudioRenderClient interface enables a client to write output data to a rendering endpoint buffer. The client obtains a reference to the IAudioRenderClient interface of a stream object by calling the IAudioClient::GetService method with parameter riid set to REFIID IID_IAudioRenderClient.

The methods in this interface manage the movement of data packets that contain audio-rendering data. The length of a data packet is expressed as the number of audio frames in the packet. The size of an audio frame is specified by the nBlockAlign member of the WAVEFORMATEX structure that the client obtains by calling the IAudioClient::GetMixFormat method. The size in bytes of an audio frame equals the number of channels in the stream multiplied by the sample size per channel. For example, the frame size is four bytes for a stereo (2-channel) stream with 16-bit samples. A packet always contains an integral number of audio frames.

When releasing an IAudioRenderClient interface instance, the client must call the interface's Release method from the same thread as the call to IAudioClient::GetService that created the object.

For code examples that use the IAudioRenderClient interface, see the following topics:

Inheritance

The IAudioRenderClient interface inherits from the IUnknown interface. IAudioRenderClient also has these types of members:

Methods

The IAudioRenderClient interface has these methods.

 
IAudioRenderClient::GetBuffer

Retrieves a pointer to the next available space in the rendering endpoint buffer into which the caller can write a data packet.
IAudioRenderClient::ReleaseBuffer

The ReleaseBuffer method releases the buffer space acquired in the previous call to the IAudioRenderClient::GetBuffer method.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header audioclient.h

See also

Core Audio Interfaces

IAudioClient::GetMixFormat

IAudioClient::GetService

WASAPI