LVSpeechPort::CreateClient

Acquires a required license and initializes the object for a subsequent speech recognition, answering machine detection, DTMF decode or grammar parse operation. The type of license that would be acquired depends on the value set for PROP_EX_LICENSE_TYPE.

Function

• int CreateClient(ExportLogMsg log_callback, void* log_callback_user_data, int log_verbosity)

Parameters

log_callback

Pointer to a function which will receive logging information from the object.

log_callback_user_data

A void pointer to client application-defined data. This data will be passed to the ExportLogMsg function to serve as a context in the callback.

log_verbosity

Sets the base verbosity level for log_callback. Range: 0 - 6. All log messages bearing verbosity greater than this value are rejected.

0 - minimal logging info

6 - maximum logging info

Return Values

LV_SUCCESS

Port initialized successfully.

LV_SYSTEM_ERROR

CreateClient was already successfully called on the instance.

LV_FAILURE

The call failed. The reason for the failure can be obtained by calling GetOpenPortStatus.

Remarks

The returned handle is used by most other API functions, and when done using it, it must be released by calling DestroyClient to release the acquired license and free up other associated resources.

See Also

• Logging Callback Function
• LVSpeechPort::DestroyClient
• LV_SRE_CreateClient (C API)