IVCmdNotifySink::AttribChanged
This method notifies applications on a voice command site that a site attribute has changed.
Syntax
HRESULT AttribChanged( DWORD dwAttribute);
Parameters
- dwAttribute
- [in] Specifies the site attribute that was changed. It is one of the following flags:
- IVCNSAC_AWAKE
- Specifies the awake state.
- IVCNSAC_AUTOGAINENABLE
- Specifies the automatic gain.
- IVCNSAC_DEVICE
- Specifies a wave-in audio device.
- IVCNSAC_ENABLED
- Specifies the enabled state.
- IVCNSAC_MICROPHONE
- Current microphone.
- IVCNSAC_ORIGINAPP
- The application receiving this notification originated the attribute change.
- IVCNSAC_SPEAKER
- Specifies the name of the current speaker.
- IVCNSAC_SRMODE
- Specifies speech-recognition mode.
- IVCNSAC_THRESHOLD
- Specifies the confidence threshold.
Return Values
The return value is ignored.
Remarks
The notification is sent only to applications that, when registered to use voice commands on the site, did one of the following:
- Set the dwFlags parameter of the IVoiceCmd::Register method to the VCMDRF_ALLBUTVUMETER value.
- Set the VCMDRF_ATTRIBCHANGE bit.
The dwAttribute parameter includes the IVCNSAC_ORIGINAPP value only if the application sets an attribute by calling the IVCmdAttributes interface’s EnabledSet, AwakeStateSet, DeviceSet, or SRModeSet method.