RxUsbQueryStringReport
Description
Obtains the array of languages supported by a USB device. Obtains the specified string descriptor of a USB device.
Syntax
rc = RxUsbQueryStringReport(Handle,Index,Language,Report)
Parameters
- Handle
- the Device Handle received from the previous RxUsbOpen.
- Index
- the Descriptor Index or 0 to obtain the array of Language Codes.
- Language
- the Language Code or 0 to use the Language Code for English.
- Report
- receives the String Report as hexadecimal string.
Return Code
0x0000 - NO_ERROR
Errors
0x0057 - ERROR_INVALID_PARAMETER 0x1B58 - USB_NOT_INIT 0xFF1F - ERROR_GEN_FAILURE 0xFF57 - ERROR_INVALID_PARAMETER
Remarks
Example Code
/* add RxUsbQueryStringReport */
rc = RxFuncAdd('RxUsbQueryStringReport','usbcalls','RxUsbQueryStringReport')
say '+RxUsbQueryStringReport(),RC=0x'd2x(rc)
/* invoke RxUsbQueryStringReport */
Index=2 /* second string descriptor index */
Language=x2d(0409) /* the english language */
drop Report /* receives string report */
rc = RxUsbQueryStringReport(Handle,Index,Language,Report)
say '*RxUsbQueryStringReport(),RC=0x'd2x(rc)
/* drop RxUsbQueryStringReport */
rc = RxFuncDrop('RxUsbQueryStringReport')
say '-RxUsbQueryStringReport(),RC=0x'd2x(rc)