Función WdfUsbInterfaceGetDescriptor (wdfusb.h)

  • Artículo

[Se aplica a KMDF y UMDF]

El método WdfUsbInterfaceGetDescriptor recupera el descriptor de interfaz USB asociado a una configuración alternativa especificada de una interfaz USB especificada.

Sintaxis

void WdfUsbInterfaceGetDescriptor(
  [in]  WDFUSBINTERFACE           UsbInterface,
  [in]  UCHAR                     SettingIndex,
  [out] PUSB_INTERFACE_DESCRIPTOR InterfaceDescriptor
);

Parámetros

[in] UsbInterface

Identificador de un objeto de interfaz USB obtenido mediante una llamada a WdfUsbTargetDeviceGetInterface.

[in] SettingIndex

Valor de índice que identifica una configuración alternativa para la interfaz. Para obtener más información sobre la configuración alternativa, consulte la especificación USB.

[out] InterfaceDescriptor

Puntero a una estructura de USB_INTERFACE_DESCRIPTOR asignada por el autor de la llamada que el marco rellena.

Valor devuelto

None

Observaciones

Si el valor SettingIndex no es válido, la estructura USB_INTERFACE_DESCRIPTOR puede recibir datos no válidos.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Para obtener más información sobre el método WdfUsbInterfaceGetDescriptor y los destinos de E/S USB, consulte Destinos de E/S USB.

Ejemplos

En el ejemplo de código siguiente se obtiene el índice de configuración alternativo para una interfaz USB especificada. A continuación, el ejemplo obtiene el descriptor de interfaz USB que representa la configuración alternativa actual de la interfaz USB.

BYTE  settingIndex;
USB_INTERFACE_DESCRIPTOR  interfaceDescriptor;

settingIndex = WdfUsbInterfaceGetConfiguredSettingIndex(
                             UsbInterface
                             );

WdfUsbInterfaceGetDescriptor(
                             UsbInterface,
                             settingIndex,
                             &interfaceDescriptor
                             );

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado wdfusb.h (incluya Wdfusb.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Consulte también

USB_INTERFACE_DESCRIPTOR

WdfUsbTargetDeviceGetInterface