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 OpenPort(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 ClosePort to release the acquired license and free up other associated resources.
This method has been deprecated in favor of CreateClient and will be removed from future releases.
See Also