Função USBD_ParseDescriptors (usbdlib.h)

A rotina USBD_ParseDescriptors pesquisa um determinado descritor de configuração e retorna um ponteiro para o primeiro descritor que corresponde aos critérios de pesquisa.

Sintaxe

PUSB_COMMON_DESCRIPTOR USBD_ParseDescriptors(
  [in] PVOID DescriptorBuffer,
  [in] ULONG TotalLength,
  [in] PVOID StartPosition,
  [in] LONG  DescriptorType
);

Parâmetros

[in] DescriptorBuffer

Ponteiro para um descritor de configuração que contém o descritor para o qual pesquisar.

[in] TotalLength

Especifica o tamanho, em bytes, do buffer apontado por DescriptorBuffer.

[in] StartPosition

Ponteiro para o endereço dentro do descritor de configuração, fornecido em DescriptorBuffer, para começar a pesquisar. Para pesquisar desde o início do descritor de configuração, os parâmetros DescriptorBuffer e StartPosition devem ser o mesmo endereço.

[in] DescriptorType

Especifica o código de tipo de descritor conforme atribuído pelo USB. Os seguintes valores são válidos para tipos de descritor definidos por USB:

USB_STRING_DESCRIPTOR_TYPE

Especifica que o descritor que está sendo pesquisado é um descritor de cadeia de caracteres.

USB_INTERFACE_DESCRIPTOR_TYPE

Especifica que o descritor que está sendo pesquisado é um descritor de interface.

USB_ENDPOINT_DESCRIPTOR_TYPE

Especifica que o descritor que está sendo pesquisado é um descritor de ponto de extremidade.

Retornar valor

USBD_ParseDescriptors retorna um ponteiro para uma estrutura USB_COMMON_DESCRIPTOR que é o cabeçalho do primeiro descritor que corresponde aos critérios de pesquisa fornecidos ou NULL será retornado se nenhuma correspondência for encontrada:

Comentários

Essa estrutura é usada para conter uma parte de um descritor, para que o chamador de USBD_ParseDescriptors possa determinar a estrutura correta a ser usada para acessar os dados restantes no descritor. Cada tipo de descritor tem esses campos no início dos dados e os chamadores podem usar os membros bLength e bDescriptorType para identificar corretamente o tipo desse descritor.

Quando essa rotina analisa o descritor de configuração que procura o descritor que corresponde aos critérios de pesquisa, ele retorna a primeira correspondência, encerrando a pesquisa.

Requisitos

Confira também

Referência de programação de driver de dispositivo USB