Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IXAudio2VoiceCallback::OnVoiceProcessingPassStart method

Called during each processing pass for each voice, just before XAudio2 reads data from the voice's buffer queue.

Syntax


virtual void OnVoiceProcessingPassStart(
   UINT32 BytesRequired
) = 0;

Parameters

BytesRequired

The number of bytes that must be submitted immediately to avoid starvation. This allows the implementation of just-in-time streaming scenarios; the client can keep the absolute minimum data queued on the voice at all times, and pass it fresh data just before the data is required. This model provides the lowest possible latency attainable with XAudio2. For xWMA and XMA data BytesRequired will always be zero, since the concept of a frame of xWMA or XMA data is meaningless.

Note  In a situation where there is always plenty of data available on the source voice, BytesRequired should always report zero, because it doesn't need any samples immediately to avoid glitching.
 

Return value

This method does not return a value.

Remarks

For information about IXAudio2VoiceCallback interface methods, see the XAudio2 Callbacks topic.

Platform Requirements

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Requirements

Header

Xaudio2.h

See also

IXAudio2VoiceCallback
XAudio2 Callbacks
How to: Use Source Voice Callbacks

 

 

Show:
© 2017 Microsoft