estrutura _URB_OS_FEATURE_DESCRIPTOR_REQUEST (usb.h)
A estrutura _URB_OS_FEATURE_DESCRIPTOR_REQUEST é usada pelo driver do hub USB para recuperar descritores de recursos do sistema operacional da Microsoft de um dispositivo USB ou de uma interface em um dispositivo USB.
Sintaxe
struct _URB_OS_FEATURE_DESCRIPTOR_REQUEST {
struct _URB_HEADER Hdr;
PVOID Reserved;
ULONG Reserved0;
ULONG TransferBufferLength;
PVOID TransferBuffer;
PMDL TransferBufferMDL;
struct _URB *UrbLink;
struct _URB_HCD_AREA hca;
UCHAR Recipient : 5;
UCHAR Reserved1 : 3;
UCHAR Reserved2;
UCHAR InterfaceNumber;
UCHAR MS_PageIndex;
USHORT MS_FeatureDescriptorIndex;
USHORT Reserved3;
};
Membros
Hdr
Ponteiro para uma estrutura de _URB_HEADER que especifica as informações do cabeçalho URB. Hdr.Function deve URB_FUNCTION_GET_MS_FEATURE_DESCRIPTOR.
Hdr.Length deve ser sizeof(_URB_OS_FEATURE_DESCRIPTOR_REQUEST).
Reserved
Reserved0
TransferBufferLength
Especifica o comprimento, em bytes, do buffer especificado em TransferBuffer ou descrito em TransferBufferMDL. O driver do controlador host retorna o número de bytes lidos neste membro. A implementação atual dessa função limita o tamanho máximo do Descritor de Recursos do MS OS a 4 Kilobytes.
TransferBuffer
Ponteiro para um buffer residente para a transferência ou é NULL se um MDL for fornecido em TransferBufferMDL.
TransferBufferMDL
Ponteiro para um MDL que descreve um buffer residente ou é NULL se um buffer for fornecido no TransferBuffer. Esse MDL deve ser alocado do pool nãopagado.
UrbLink
Reservado. Não use.
hca
Recipient
Especifica se o destinatário é o dispositivo USB ou uma interface no dispositivo USB. Um dos seguintes valores deve ser especificado:
- 0 indica que o dispositivo USB é o destinatário da solicitação.
- 1 indica que uma interface USB é o destinatário da solicitação.
- 2 indica que um ponto de extremidade USB é o destinatário da solicitação.
Reserved1
Reserved2
InterfaceNumber
Indica o número da interface que é o destinatário da solicitação, se o valor do membro destinatário for 1. Deve ser definido como 0 se o dispositivo USB for o destinatário.
MS_PageIndex
Deve ser definido como 0. Índice de página da página 64K do Descritor de Recursos do MS OS a ser retornado. A implementação atual dá suporte apenas a um tamanho máximo de descritor de 4K.
MS_FeatureDescriptorIndex
Indexe para o Descritor de Recursos do SO MS a ser solicitado.
Reserved3
Comentários
Os membros reservados dessa estrutura devem ser tratados como opacos e são reservados para uso do sistema.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows XP e em sistemas operacionais posteriores. |
| Cabeçalho | usb.h (inclua Usb.h) |