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 que se obtuvo llamando 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
Ninguno
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 de 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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfusb.h (incluya Wdfusb.h) |
| biblioteca de | 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) |