WdfUsbInterfaceGetInterfaceNumber function (wdfusb.h)

[Applies to KMDF and UMDF]

The WdfUsbInterfaceGetInterfaceNumber method returns the interface number of a specified USB interface object.

Syntax

BYTE WdfUsbInterfaceGetInterfaceNumber(
  [in] WDFUSBINTERFACE UsbInterface
);

Parameters

[in] UsbInterface

A handle to a USB interface object that was obtained by calling WdfUsbTargetDeviceGetInterface.

Return value

WdfUsbInterfaceGetInterfaceNumber returns the interface number.

A bug check occurs if the driver supplies an invalid object handle.

Remarks

For more information about interface numbers, see the USB specification.

For more information about the WdfUsbInterfaceGetInterfaceNumber method and USB I/O targets, see USB I/O Targets.

Examples

The following code example obtains the interface number of a specified USB interface object.

BYTE interfaceNumber; 

interfaceNumber = WdfUsbInterfaceGetInterfaceNumber(UsbInterface);

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Minimum UMDF version 2.0
Header wdfusb.h (include Wdfusb.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI compliance rules DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

See also

WdfUsbTargetDeviceGetInterface