VTSITEINFO

This structure specifies an audio device, a text-to-speech (TTS) mode, and the talking speed for a voice text site, and indicates whether voice text is enabled or disabled for the voice text site.

Syntax

typedef struct { // vtsi
DWORD dwDevice;
DWORD dwEnable;
DWORD dwSpeed;
GUID gModeID;
} VTSITEINFO, *PVTSITEINFO;

Members

dwDevice

Specifies the device identifier of the WAV output audio device to be used by the site. The device identifier can be obtained by calling the waveOutGetNumDevs and waveOutGetDevCaps multimedia functions.

dwEnable

Specifies whether voice text is enabled. TRUE indicates that voice text is enabled for the site; FALSE indicates it is disabled.

dwSpeed

Specifies a baseline average talking speed, in words per minute, for the text-to-speech mode to be used by the site.

gModeID

Globally unique identifier (GUID) of the text-to-speech mode to be used by the site. The GUID for a text-to-speech mode is obtained from a text-to-speech enumerator object.

Remarks

An application can specify the address of a VTSITEINFO structure in a call to the IVoiceText::Register method to set the voice, speaking speed, and other attributes of a voice-text site, even if the site is already open. Telephony applications typically do this to ensure that the proper information is selected for the site.