función USBD_ParseConfigurationDescriptorEx (usbdlib.h)
La rutina USBD_ParseConfigurationDescriptorEx busca en un descriptor de configuración determinado y devuelve un puntero a una interfaz que coincide con los criterios de búsqueda especificados.
Sintaxis
PUSB_INTERFACE_DESCRIPTOR USBD_ParseConfigurationDescriptorEx(
[in] PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
[in] PVOID StartPosition,
[in] LONG InterfaceNumber,
[in] LONG AlternateSetting,
[in] LONG InterfaceClass,
[in] LONG InterfaceSubClass,
[in] LONG InterfaceProtocol
);
Parámetros
[in] ConfigurationDescriptor
Puntero a un descriptor de configuración USB que contiene la interfaz para la que se va a buscar.
[in] StartPosition
Puntero a la dirección dentro del descriptor de configuración, proporcionado en ConfigurationDescriptor, para empezar a buscar. Para buscar desde el principio del descriptor de configuración, los parámetros ConfigurationDescriptor y StartPosition deben ser la misma dirección.
[in] InterfaceNumber
Especifica el índice definido por el dispositivo de la interfaz que se va a recuperar. Debe establecerse en -1 si no debe ser un criterio de búsqueda.
[in] AlternateSetting
Especifica el índice de configuración alternativa definido por el dispositivo de la interfaz que se va a recuperar. Si el autor de la llamada no desea que el valor de configuración alternativo sea un criterio de búsqueda, este parámetro debe establecerse en -1.
[in] InterfaceClass
Especifica el identificador definido por el dispositivo o USB para la clase de interfaz de la interfaz que se va a recuperar. Si el autor de la llamada no desea que el valor de la clase de interfaz sea un criterio de búsqueda, este parámetro debe establecerse en -1.
[in] InterfaceSubClass
Especifica el identificador definido por el dispositivo o USB para la subclase de interfaz de la interfaz que se va a recuperar. Si el autor de la llamada no desea que el valor de la subclase de interfaz sea un criterio de búsqueda, este parámetro debe establecerse en -1.
[in] InterfaceProtocol
Especifica el identificador definido por el dispositivo o USB para el protocolo de interfaz de la interfaz que se va a recuperar. Si el autor de la llamada no desea que el valor del protocolo de interfaz sea un criterio de búsqueda, este parámetro debe establecerse en -1.
Valor devuelto
USBD_ParseConfigurationDescriptorEx devuelve un puntero al primer descriptor de interfaz que coincide con los criterios de búsqueda especificados. Si ninguna interfaz coincide con los criterios de búsqueda, devuelve NULL.
Observaciones
Los autores de llamadas pueden especificar más de uno de los criterios de búsqueda (InterfaceNumber, AlternateSetting, InterfaceClass, InterfaceSubClass e InterfaceProtocol) al usar esta rutina para buscar una interfaz dentro de un descriptor de configuración. Para obtener código de ejemplo, vea USBD_CreateConfigurationRequestEx.
Cuando esta rutina analiza el descriptor de configuración que busca el descriptor de interfaz que coincide con los criterios de búsqueda, devuelve la primera coincidencia, finalizando la búsqueda. Los autores de llamadas deben especificar tantos criterios de búsqueda como sea necesario para encontrar la interfaz deseada.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | usbdlib.h (include Usbdlib.h) |
| biblioteca de | Usbd.lib |
| irQL | < DISPATCH_LEVEL |
Consulte también
referencia de programación del controlador de dispositivo USB