gvFilterCallback

GameSpy SDK

gvFilterCallback

Used to filter audio that has either been captured or is about to be played. Can also be used to monitor audio.

typedef void (*gvFilterCallback)(
GVDevice device,
GVSample * audio,
GVFrameStamp frameStamp );
RoutineRequired HeaderDistribution
gvFilterCallback<gv.h>SDKZIP

Parameters

device
[in] The handle to the device.
audio
[ref] A frame of audio to be filtered.
frameStamp
[in] The framestamp for the frame of audio.

Remarks

Filtering allows you to process, or just monitor, audio that has ben captured or is being played. The audio will always be a single raw frame of audio. Use gvGetCodecInfo to get the number of samples in a raw frame.
The callback can modify the audio in any way that it wants. However once the function returns it can no longer access the audio. For capture devices, audio will only be passed to the filter if it crosses the threshold (if one is set). For playback devices, audio is filtered after all of the sources have been mixed.

Section Reference: Gamespy Voice SDK

See Also: gvSetFilter