Función WdfUsbInterfaceGetDescriptor (wdfusb.h)
[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) |