estrutura _URB_CONTROL_GET_STATUS_REQUEST (usb.h)

A estrutura _URB_CONTROL_GET_STATUS_REQUEST é usada por drivers de cliente USB para recuperar status de um dispositivo, interface, ponto de extremidade ou outro destino definido pelo dispositivo.

Sintaxe

struct _URB_CONTROL_GET_STATUS_REQUEST {
  struct _URB_HEADER   Hdr;
  PVOID                Reserved;
  ULONG                Reserved0;
  ULONG                TransferBufferLength;
  PVOID                TransferBuffer;
  PMDL                 TransferBufferMDL;
  struct _URB          *UrbLink;
  struct _URB_HCD_AREA hca;
  UCHAR                Reserved1[4];
  USHORT               Index;
  USHORT               Reserved2;
};

Membros

Hdr

Ponteiro para uma estrutura _URB_HEADER que especifica as informações do cabeçalho URB. Hdr.Length deve ser sizeof(_URB_CONTROL_GET_STATUS_REQUEST)e Hdr.Function deve ser um dos seguintes valores:

• URB_FUNCTION_GET_STATUS_FROM_DEVICE
• URB_FUNCTION_GET_STATUS_FROM_INTERFACE
• URB_FUNCTION_GET_STATUS_FROM_ENDPOINT
• URB_FUNCTION_GET_STATUS_FROM_OTHER

Reserved

Reservado. Não use.

Reserved0

Reservado. Não use.

TransferBufferLength

Deve ser 2. Esse membro 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 enviados ou lidos do pipe neste membro.

TransferBuffer

Ponteiro para um buffer residente para a transferência ou será NULL se um MDL for fornecido em TransferBufferMDL. O driver de ônibus retorna um único byte especificando o status para o destino.

TransferBufferMDL

Ponteiro para um MDL que descreve um buffer residente ou é NULL se um buffer for fornecido no TransferBuffer. O driver de ônibus retorna um único byte especificando o status para o destino. Esse MDL deve ser alocado do pool nãopagado.

UrbLink

Reservado. Não use.

hca

Reservado. Não use.

Reserved1[4]

Reservado. Não use.

Index

Especifica o índice definido pelo dispositivo, retornado por uma solicitação de configuração bem-sucedida, se a solicitação for para um ponto de extremidade ou interface. Caso contrário, Índice deve ser zero.

Reserved2

Reservado. Não use.

Comentários

Os drivers podem usar a rotina de serviço UsbBuildGetStatusRequest para formatar esse URB.

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

Requisitos

Confira também

URB

Estruturas USB

_URB_HEADER