gvListTalkingSources
Gets a list of all of the sources that are currently talking on a particular device.
- int gvListTalkingSources(
- GVDevice device,
- GVSource sources[],
- int maxSources );
| Routine | Required Header | Distribution |
|---|---|---|
| gvListTalkingSources | <gv.h> | SDKZIP |
Return Value
Returns the number of sources that are talking on the device.
Parameters
- device
- [in] The handle of the device.
- sources
- [out] An array to receive the sources, filled in by the function.
- maxSources
- [in] The number of elements in the sources array.
Remarks
The function will return the number of sources that were talking on the device, and it will store their GVSources in the sources array. 0 will be returned if there are no sources talking.
GV has a hardcoded limit that does not allow more than 8 sources to talk simultaneously. This allows it to preallocate memory that it needs to store for a source while it is talking. A user will typically not understand more than 2 or 3 users talking simultaneously, so the limit should be high enough. If the application attempts to play audio from more than 8 sources at a time, audio for the 9th source will be automatically dropped.
Section Reference: Gamespy Voice SDK
See Also: gvIsSourceTalking