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
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | usbdlib.h (inclua Usbdlib.h) |
| Biblioteca | Usbd.lib |
| IRQL | < DISPATCH_LEVEL |