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

usbd_setup_control()

Set up a URB for a control transfer

---

This function isn't currently implemented. To set up a URB for a control transfer, use usbd_setup_vendor() instead.

---

Synopsis:

#include <sys/usbdi.h>

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

Arguments:

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 the direction.

You can optionally OR in the following:

• URB_SHORT_XFER_OK--allow short transfers.

request

A device-specific request.

rtype

The type of request; one of the following:

• USB_RECIPIENT_DEVICE
• USB_RECIPIENT_INTERFACE
• USB_RECIPIENT_ENDPOINT
• USB_RECIPIENT_OTHER

ORed with one of the following:

• 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

The address for the start of the transfer. You must use the buffer allocated by usbd_alloc().

len

The length (in bytes) of the data transfer.

Library:

libusbdi

Description:

This routine sets up a URB for a control 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_interrupt(), usbd_setup_isochronous(), usbd_setup_vendor(), usbd_status()