View source for RxUsbDeviceGetDescriptor

==Description==
Executes the Standard Device Request that obtains the Device Descriptor. 

==Syntax==
<pre>
rc = RxUsbDeviceGetDescriptor(Handle,Length,Descriptor)
</pre>

==Parameters==
; Handle : the Device Handle received from the previous RxUsbOpen. 

; Length : the desired number of bytes or 0 for the whole Device Descriptor. 

; Descriptor : the name of the variable to receive the Device Descriptor. 

==Return Code==
<pre>
0x0000 - NO_ERROR
</pre>
===Errors===
<pre>
0x0006 - ERROR_INVALID_HANDLE
0x0008 - ERROR_NOT_ENOUGH_MEMORY
0x0057 - ERROR_INVALID_PARAMETER
0x005F - ERROR_INTERRUPT
0x0122 - ERROR_TOO_MANY_HANDLES
0x0280 - ERROR_TIMEOUT
0x1B58 - USB_NOT_INIT
0x4000 - USB_IORB_REQUEST
0x80XX - USB_IORB_FAILED
0xFF0D - ERROR_INVALID_DATA
0xFF13 - ERROR_I24_INVALID_PARAMETER
0xFF13 - USB_IDC_PARMERR
0xFF18 - USB_IDC_ADDRINV
0xFF37 - ERROR_DEV_NOT_EXIST
0xFF5D - EROR_NO_ITEMS
0xFFA7 - ERROR_LOCK_FAILED
</pre>

==Remarks==

==Example Code==
<pre>
/* add RxUsbDeviceGetDescriptor */
rc = RxFuncAdd('RxUsbDeviceGetDescriptor','usbcalls','RxUsbDeviceGetDescriptor')
say '+RxUsbDeviceGetDescriptor(),RC=0x'd2x(rc)

/* invoke RxUsbDeviceGetDescriptor */
Length=18 /* to receive whole descriptor */
drop Descriptor /* receives device descriptor */
rc = RxUsbDeviceGetDescriptor(Handle,Length,Descriptor)
say '*RxUsbDeviceGetDescriptor(),RC=0x'd2x(rc)

/* drop RxUsbDeviceGetDescriptor */
rc = RxFuncDrop('RxUsbDeviceGetDescriptor')
say '-RxUsbDeviceGetDescriptor(),RC=0x'd2x(rc)
</pre>

==Related Functions==
* [[RxUsbQueryDeviceReport]]
* [[RxUsbConfigurationGetDescriptor]]
* [[RxUsbStringGetDescriptor]]
* [[RxUsbDeviceSetDescriptor]]
* [[RxUsbCtrlMessage]]
* [[RxUsbOpen]]

[[Category:USBCalls]]