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

usbd_hcd_ext_info(), usbd_hcd_info()

Get information on the USB host controller and DDK library

Synopsis:

#include <sys/usbdi.h>

int usbd_hcd_ext_info( struct usbd_connection *connection,
                       _uint32 cindex,
                       usbd_hcd_info_t *info );

int usbd_hcd_info( struct usbd_connection *connection,
                   usbd_hcd_info_t *info );

Arguments:

connection

The handle for the connection to the USB stack, obtained by calling usbd_connect().

cindex

(usbd_hcd_ext_info() only) The index of the host controller.

info

A pointer to a usbd_hcd_info_t data structure that this function fills in.

Library:

libusbdi

Description:

You can use the usbd_hcd_ext_info() or usbd_hcd_info() function to obtain information from the USB host controller and DDK library.

If your system has more than one USB chip, you can call usbd_hcd_ext_info() to get information about a specific one. The usbd_hcd_info() function gets information about the first USB chip; calling it is the same as calling usbd_hcd_ext_info() with a cindex argument of 0.

The usbd_hcd_info_t structure is defined as follows:

 
typedef struct usbd_hcd_info {
    _uint16                 vusb;
    _uint16                 vusbd;
    char                    controller[8];
    _uint32                 capabilities;
    _uint8                  ndev;
    _uint8                  cindex;
    _uint16                 vhcd;
    _uint32                 max_td_io;
    _uint8                  reserved[12];
  } usbd_hcd_info_t;

It contains at least the following:

vusb

The version number of the USB stack.

vusbd

The version number of the USB DDK.

controller

The name of the USB host controller.

capabilities

The capabilities of the USB host controller.

ndev

The number of devices currently connected.

cindex

The index of the host controller.

vhcd

The version number of the USB HCD.

max_td_io

The maximum number of bytes per HC TD.

Returns:

EOK

Success.

Classification:

QNX Neutrino, QNX 4

See also:

usbd_args_lookup(), usbd_configuration_descriptor(), usbd_device_lookup(), usbd_device_extra(), usbd_device_descriptor(), usbd_endpoint_descriptor(), usbd_hub_descriptor(), usbd_interface_descriptor(), usbd_languages_descriptor(), usbd_parse_descriptors(), usbd_string(), usbd_urb_status()