gvStartDevice

GameSpy SDK

gvStartDevice

Starts a device capturing and/or playing audio.

GVBool gvStartDevice(
GVDevice device,
GVDeviceType type );
RoutineRequired HeaderDistribution
gvStartDevice<gv.h>SDKZIP

Return Value

GVTrue if the device was started succesfully.

Parameters

device
[in] The handle to the device.
type
[in] Specifies capture, playback, or both.

Remarks

Once a device has been initialized, it is ready to start capturing or playing audio. After a capture device is started, it will begin capturing audio and passing it back to the application. After a playback device is started, it will play any audio that the application passes it. To start a device, use gvStartDevice.

The device parameter is the handle of the device to start. The type parameter specifies if the device should start capturing (GV_CAPTURE), playing (GV_PLAYBACK), or capturing and playing (GV_CAPTURE_AND_PLAYBACK). For devices that support both capture and playback, each can be started independently. The function will return GVTrue if the device was started successfully, and it will return GVFalse if there was an error.

Section Reference: Gamespy Voice SDK

See Also: gvStopDevice, gvIsDeviceStarted