структура _URB_CONTROL_GET_STATUS_REQUEST (usb.h)

Статья
08/07/2023

Структура _URB_CONTROL_GET_STATUS_REQUEST используется драйверами USB-клиента для получения состояния с устройства, интерфейса, конечной точки или другого целевого объекта, определенного устройством.

Синтаксис

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

Члены

Hdr

Указатель на структуру _URB_HEADER , указывающую сведения о заголовке URB. Hdr.Length должен иметь значение sizeof(_URB_CONTROL_GET_STATUS_REQUEST), а Hdr.Function — одно из следующих значений:

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

Зарезервировано. Не используется.

Reserved0

Зарезервировано. Не используется.

TransferBufferLength

Должно быть 2. Этот член задает длину буфера в байтах, указанного в параметре TransferBuffer или описанного в разделе TransferBufferMDL. Драйвер хост-контроллера возвращает количество байтов, отправленных или считанных из канала в этом элементе.

TransferBuffer

Указатель на постоянный буфер для передачи или имеет значение NULL , если MDL предоставляется в TransferBufferMDL. Драйвер автобуса возвращает один байт, указывающий состояние целевого объекта.

TransferBufferMDL

Указатель на MDL, описывающий постоянный буфер, или имеет значение NULL , если буфер предоставляется в TransferBuffer. Драйвер автобуса возвращает один байт, указывающий состояние целевого объекта. Этот MDL должен быть выделен из непагрегированного пула.

UrbLink

Зарезервировано. Не используется.

hca

Зарезервировано. Не используется.

Reserved1[4]

Зарезервировано. Не используется.

Index

Указывает определяемый устройством индекс, возвращаемый успешным запросом конфигурации, если запрос предназначен для конечной точки или интерфейса. В противном случае значение Index должно быть равно нулю.

Reserved2

Зарезервировано. Не используется.