GetUSBDIVersion routine

The GetUSBDIVersion routine returns the USB interface version number and the version number of the USB specification that defines the interface, along with information about host controller capabilities.

Note  USBD_IsInterfaceVersionSupported replaces the GetUSBDIVersion routine. To determine the capabilities of the host controller and the underlying USB driver stack, call USBD_QueryUsbCapability.

Syntax

VOID GetUSBDIVersion(
  _In_       PVOID BusContext,
  _Out_opt_  PUSBD_VERSION_INFORMATION VersionInformation,
  _Out_opt_  PULONG HcdCapabilities
);

Parameters

BusContext [in]

Handle returned in the BusContext member of the USB_BUS_INTERFACE_USBDI_V0 structure by an IRP_MN_QUERY_INTERFACE request.

VersionInformation [out, optional]

Returns a pointer to a USBD_VERSION_INFORMATION structure that contains the USB interface version number and the USB specification version number.

HcdCapabilities [out, optional]

Returns the host capability flags. Currently, no host capability flags are reported.

Return value

This routine does not return a value.

Remarks

The function returns the highest USBDI Interface Version supported by the port driver. This function replaces the USBD_GetUSBDIVersion library function provided by usbd.sys.

The function definition that is provided on this reference page is an example function whose parameters are just placeholder names. The actual prototype of the function is declared in usbbusif.h as follows:

typedef VOID
  (USB_BUSIFFN *PUSB_BUSIFFN_GETUSBDI_VERSION) (
    IN PVOID,
    IN OUT PUSBD_VERSION_INFORMATION,
    IN OUT PULONG 
  );

Requirements

See also

USBD_VERSION_INFORMATION

USBD_GetUSBDIVersion

USB_BUS_INTERFACE_USBDI_V0

Bus Driver Interface Routines for USB Client Drivers

Send comments about this topic to Microsoft

Build date: 12/5/2013