VCSITEINFO

typedef struct { // vcsi
DWORD dwAutoGainEnable;
DWORD dwAwakeState;
DWORD dwThreshold;
DWORD dwDevice;
DWORD dwEnable;
TCHAR szMicrophone[VCMD_MICLEN];
TCHAR szSpeaker[VCMD_SPEAKERLEN];
GUID gModeID;
} VCSITEINFO, *PVCSITEINFO

Provides information about the audio device, speech-recognition mode, and other attributes of a voice-command site.

dwAutoGainEnable

Value from 0 to 100 that indicates the state of the automatic gain for the incoming audio stream to be used by the site.

dwAwakeState

TRUE if the site is awake for purposes of speech-recognition or FALSE if the site is asleep.

dwThreshold

Value from 0 to 100 that indicates the recognition threshold for the speech-recognition engine to be used by the site.

dwDevice

Device identifier of the wave-in audio device to be used by the site. The device identifier can be obtained by calling the waveInGetNumDevs and waveInGetDevCaps multimedia functions.

dwEnable

TRUE if speech recognition is enabled for the site or FALSE if speech recognition is disabled.

szMicrophone

Name of the current microphone for the audio source to be used by the site.

szSpeaker

Name of the current speaker for the site.

gModeID

GUID that uniquely identifies the speech-recognition mode to be used by the site. The GUID for a speech-recognition mode can be obtained by using a speech-recognition enumerator. For more information about speech-recognition enumerators, see section, "Low-Level Speech Recognition API."

An application can pass a pointer to a VCSITEINFO structure with the IVoiceCmd::Register function to set the audio device, speech-recognition mode, and other attributes of a voice-command site, even if the site is already open.