---
name: "usb_ifnum_to_if"
section: "9"
platform: "linux"
package: "linux-manual-4.9"
version: "4.9.228-1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/usb_ifnum_to_if"
---

# usb\_ifnum\_to\_if(9)

get the interface object with a given interface number

## NAME

usb\_ifnum\_to\_if - get the interface object with a given interface number

## SYNOPSIS

**struct usb\_interface \* usb\_ifnum\_to\_if(const struct usb\_device \*** *dev***, unsigned** *ifnum***);**

## ARGUMENTS

*dev*

the device whose current configuration is considered

*ifnum*

the desired interface

## DESCRIPTION

This walks the device descriptor for the currently active configuration to find the interface object with the particular interface number.

Note that configuration descriptors are not required to assign interface numbers sequentially, so that it would be incorrect to assume that the first interface in that descriptor corresponds to interface zero. This routine helps device drivers avoid such mistakes. However, you should make sure that you do the right thing with any alternate settings available for this interfaces.

Don't call this function unless you are bound to one of the interfaces on this device or you have locked the device!

## RETURN

A pointer to the interface that has *ifnum* as interface number, if found. **NULL** otherwise.

## COPYRIGHT