Compartir a través de

estructura _URB_CONTROL_GET_STATUS_REQUEST (usb.h)

  • Artículo

Los controladores de cliente USB usan la estructura _URB_CONTROL_GET_STATUS_REQUEST para recuperar el estado de un dispositivo, una interfaz, un punto de conexión u otro destino definido por el dispositivo.

Sintaxis

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;
};

Miembros

Hdr

Puntero a una estructura de _URB_HEADER que especifica la información del encabezado URB. Hdr.Length debe ser sizeof(_URB_CONTROL_GET_STATUS_REQUEST), y Hdr.Function debe ser uno de los siguientes 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. No utilizar.

Reserved0

Reservado. No utilizar.

TransferBufferLength

Debe ser 2. Este miembro especifica la longitud, en bytes, del búfer especificado en TransferBuffer o descrito en TransferBufferMDL. El controlador del controlador de host devuelve el número de bytes enviados o leídos desde la canalización de este miembro.

TransferBuffer

Puntero a un búfer residente para la transferencia o es NULL si se proporciona una MDL en TransferBufferMDL. El controlador de bus devuelve un solo byte que especifica el estado del destino.

TransferBufferMDL

Puntero a una MDL que describe un búfer residente o es NULL si se proporciona un búfer en TransferBuffer. El controlador de bus devuelve un solo byte que especifica el estado del destino. Este MDL debe asignarse desde un grupo no paginado.

UrbLink

Reservado. No utilizar.

hca

Reservado. No utilizar.

Reserved1[4]

Reservado. No utilizar.

Index

Especifica el índice definido por el dispositivo, devuelto por una solicitud de configuración correcta, si la solicitud es para un punto de conexión o interfaz. De lo contrario, Index debe ser cero.

Reserved2

Reservado. No utilizar.

Comentarios

Los controladores pueden usar la rutina de servicio UsbBuildGetStatusRequest para dar formato a este URB.

Los miembros reservados de esta estructura deben tratarse como opacos y están reservados para uso del sistema.

Requisitos

Requisito Valor
Header usb.h (incluya Usb.h)

Consulte también

URB

Estructuras USB

_URB_HEADER