IVCmdAttributes::SRModeGet

This method gets the globally unique identifier (GUID) of the speech-recognition mode used for the site.

Syntax

HRESULT SRModeGet( GUID *pgMode);

Parameters

pgMode

[out] Pointer to the variable that receives the GUID assigned to the speech-recognition mode.

Return Values

NOERROR

The method successfully retrieved the GUID of the speech-recognition mode.

E_INVALIDARG

The argument is invalid.

VCMDERR_INVALIDMODE

No site exists, the site does not support this attribute, or the voice command object is already registered with a site.

VCMDERR_NOTSUPPORTED

The function is not supported by the engine.

VCMDERR_OUTOFMEM

There is no more memory.

Remarks

A speech-recognition engine typically provides an assortment of modes that it can use to recognize speech in different languages or dialects. A voice command site uses a single speech-recognition mode.

The speech-recognition mode for a site is saved between uses of the site, even if the user shuts down the computer in the meantime.

For an Auto PC, there is usually only one speech recognition mode.