|
virtual int | getUserString (long deviceID, int *errorCode, char *buffer, int bufferLength) |
|
virtual int | getUserString (long deviceID, int *errorCode, int index, char *buffer, int bufferLength) |
|
virtual int | getUserStringCount (long deviceID, int *errorCode) |
|
virtual void | setUserString (long deviceID, int *errorCode, char *buffer, int bufferLength) |
|
virtual void | setUserString (long deviceID, int *errorCode, int index, char *buffer, int bufferLength) |
|
◆ getUserString() [1/2]
virtual int oceandirect::api::UserStringAPI::getUserString |
( |
long |
deviceID, |
|
|
int * |
errorCode, |
|
|
char * |
buffer, |
|
|
int |
bufferLength |
|
) |
| |
|
virtual |
Read the user string from the device. If this field in the device is not yet populated then a non-zero(6) code will be returned.
- See also
- setUserString()
- Parameters
-
deviceID | the ID of the device returned by getDeviceIDs. |
errorCode | a code indicating the result of the operation: ERROR_SUCCESS on success; ERROR_NO_DEVICE if the device does not exist; ERROR_FEATURE_NOT_FOUND the feature is not enabled on the specified device; ERROR_TRANSFER_ERROR the device protocol for the feature could not be found; ERROR_CODE_INVALID_ARGUMENT the interface number is not 0 or 1. |
buffer | The output buffer containing user string. |
buffer_length | The buffer size should be at least 16. |
- Returns
- The user string lengnth.
◆ getUserString() [2/2]
virtual int oceandirect::api::UserStringAPI::getUserString |
( |
long |
deviceID, |
|
|
int * |
errorCode, |
|
|
int |
index, |
|
|
char * |
buffer, |
|
|
int |
bufferLength |
|
) |
| |
|
virtual |
Read the user string from the device. The maximum string length is 16. If this field in the device is not yet populated then a non-zero(6) code will be returned. If the device don't support this command then a non-zero error code will be returned.
- Parameters
-
deviceID | the ID of the device returned by getDeviceIDs. |
errorCode | a code indicating the result of the operation: ERROR_SUCCESS on success; ERROR_NO_DEVICE if the device does not exist; ERROR_FEATURE_NOT_FOUND the feature is not enabled on the specified device; ERROR_TRANSFER_ERROR the device protocol for the feature could not be found; ERROR_CODE_INVALID_ARGUMENT the interface number is not 0 or 1. |
index | The user string index. |
buffer | The output buffer for user string. |
buffer_length | The maximum buffer size is 16. |
◆ getUserStringCount()
virtual int oceandirect::api::UserStringAPI::getUserStringCount |
( |
long |
deviceID, |
|
|
int * |
errorCode |
|
) |
| |
|
virtual |
Read the total user string count from the device. If the device don't support this command then a non-zero error code will be returned.
- Parameters
-
deviceID | the ID of the device returned by getDeviceIDs. |
errorCode | a code indicating the result of the operation: ERROR_SUCCESS on success; ERROR_NO_DEVICE if the device does not exist; ERROR_FEATURE_NOT_FOUND the feature is not enabled on the specified device; ERROR_TRANSFER_ERROR the device protocol for the feature could not be found; ERROR_CODE_INVALID_ARGUMENT the interface number is not 0 or 1. |
- Returns
- The total user string count.
◆ setUserString() [1/2]
virtual void oceandirect::api::UserStringAPI::setUserString |
( |
long |
deviceID, |
|
|
int * |
errorCode, |
|
|
char * |
buffer, |
|
|
int |
bufferLength |
|
) |
| |
|
virtual |
Write the user string to the device. The maximum string length is 16.
- See also
- getUserString()
- Parameters
-
deviceID | the ID of the device returned by getDeviceIDs. |
errorCode | a code indicating the result of the operation: ERROR_SUCCESS on success; ERROR_NO_DEVICE if the device does not exist; ERROR_FEATURE_NOT_FOUND the feature is not enabled on the specified device; ERROR_TRANSFER_ERROR the device protocol for the feature could not be found; ERROR_CODE_INVALID_ARGUMENT the interface number is not 0 or 1. |
buffer | The buffer containing a user string. |
buffer_length | The maximum buffer size is 16. |
◆ setUserString() [2/2]
virtual void oceandirect::api::UserStringAPI::setUserString |
( |
long |
deviceID, |
|
|
int * |
errorCode, |
|
|
int |
index, |
|
|
char * |
buffer, |
|
|
int |
bufferLength |
|
) |
| |
|
virtual |
Write the user string to the device. The maximum string length is 16. If the device don't support this command then a non-zero error code will be returned.
- Parameters
-
deviceID | the ID of the device returned by getDeviceIDs. |
errorCode | a code indicating the result of the operation: ERROR_SUCCESS on success; ERROR_NO_DEVICE if the device does not exist; ERROR_FEATURE_NOT_FOUND the feature is not enabled on the specified device; ERROR_TRANSFER_ERROR the device protocol for the feature could not be found; ERROR_CODE_INVALID_ARGUMENT the interface number is not 0 or 1. |
index | The user string index. |
buffer | The new user string. |
buffer_length | The maximum buffer size is 16. |
The documentation for this class was generated from the following file: