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

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)

Related Functions

 * RxUsbQueryDeviceReport
 * RxUsbOpen