IWDFUsbInterface::GetInterfaceDescriptor method

[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]

The GetInterfaceDescriptor method retrieves a descriptor for a USB interface.

Syntax


void GetInterfaceDescriptor(
  [out] PUSB_INTERFACE_DESCRIPTOR UsbAltInterfaceDescriptor
);

Parameters

UsbAltInterfaceDescriptor [out]

A pointer to a variable that receives the USB interface descriptor.

Return value

None

Remarks

After a UMDF driver calls the IWDFUsbTargetDevice::RetrieveUsbInterface method to retrieve the first USB interface for the USB device, a UMDF driver should retrieve the descriptor for the USB interface. Therefore, the GetInterfaceDescriptor method does not fail.

For a code example of how to use the GetInterfaceDescriptor method, see IWDFUsbTargetFactory::CreateUsbTargetDevice.

Requirements

Target platform

Desktop

End of support

Unavailable in UMDF 2.0 and later.

Minimum UMDF version

1.5

Header

Wudfusb.h (include Wudfusb.h)

DLL

WUDFx.dll

See also

IWDFUsbInterface
IWDFUsbTargetDevice::RetrieveUsbInterface

 

 

Send comments about this topic to Microsoft

Show: