estrutura _URB_OS_FEATURE_DESCRIPTOR_REQUEST (usb.h)

Artigo
02/07/2025

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 de 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 em 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 Destinatário valor de membro 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 SISTEMA OPERACIONAL MS a ser retornado. A implementação atual dá suporte apenas a um tamanho máximo de descritor de 4K.

MS_FeatureDescriptorIndex

Índice para o Descritor de Recursos do SO MS a ser solicitado.

Reserved3

Observações

Os membros reservados dessa estrutura devem ser tratados como opacos e reservados para uso do sistema.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows XP e em sistemas operacionais posteriores.
cabeçalho	usb.h (incluir Usb.h)

Consulte também

URB

_URB_HEADER

Partilhar via