función USBD_ParseConfigurationDescriptorEx (usbdlib.h)

La rutina USBD_ParseConfigurationDescriptorEx busca 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 e 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.

Comentarios

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 sean necesarios para encontrar la interfaz deseada.

Requisitos

Consulte también

Referencia de programación del controlador de dispositivo USB

USB_CONFIGURATION_DESCRIPTOR