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)

Confira também

URB

_URB_HEADER