This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

usbd_setup_vendor()

Set up a URB for a vendor-specific transfer

Synopsis:

#include <sys/usbdi.h>

int usbd_setup_vendor( struct usbd_urb *urb, 
                       _uint32 flags, _uint16 request, 
                       _uint16 rtype, _uint16 value, 
                       _uint16 index, void *addr, 
                       _uint32 len );

Description:

This routine sets up a URB for a vendor-specific transfer.

For this release of the USB SDK, vendor requests are synchronous only. Therefore, the func parameter in usbd_io() must be NULL.

urb

An opaque handle (from usbd_alloc_urb()).

flags

One of the following:

• URB_DIR_IN -- Specify incoming (device-to-PC) transfer.
• URB_DIR_OUT -- Specify outgoing (PC-to-device) transfer.
• URB_DIR_NONE -- Don't specify direction.
• URB_SHORT_XFER_OK -- Allow short transfers.

request

A device-specific request.

rtype

Type of request (e.g. USB_RECIPIENT_DEVICE, USB_RECIPIENT_INTERFACE, USB_RECIPIENT_ENDPOINT, USB_RECIPIENT_OTHER, USB_TYPE_STANDARD, USB_TYPE_CLASS, USB_TYPE_VENDOR).

value

This varies, depending on the request. It's used for passing a parameter to the device.

index

This varies, depending on the request. It's used for passing a parameter to the device.

addr

Address for start of transfer -- you must use the buffer allocated by usbd_alloc().

len

The length (in bytes) of the data transfer.

Returns:

EOK

Success.

Classification:

QNX Neutrino, QNX 4

Caveats:

To ensure that the correct physical address will be used, you must use the buffer allocated by usbd_alloc() for the addr parameter.

See also:

usbd_descriptor(), usbd_feature(), usbd_io(), usbd_setup_bulk(), usbd_setup_control(), usbd_setup_interrupt(), usbd_setup_isochronous(), usbd_status()