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

Статья
08/07/2023

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

Синтаксис

struct _URB_SELECT_CONFIGURATION {
  struct _URB_HEADER            Hdr;
  PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor;
  USBD_CONFIGURATION_HANDLE     ConfigurationHandle;
  USBD_INTERFACE_INFORMATION    Interface;
};

Члены

Hdr

Указатель на структуру _URB_HEADER , указывающую сведения о заголовке URB. Hdr.Function должен быть URB_FUNCTION_SELECT_CONFIGURATION, а Hdr.Length должен быть размером всей urb. Драйверы могут использовать макрос GET_SELECT_CONFIGURATION_REQUEST_SIZE, определенный в usbdlib.h, для получения размера URB.

ConfigurationDescriptor

Указатель на инициализированный дескриптор конфигурации USB, который определяет конфигурацию, используемую на устройстве. Если этот элемент имеет значение NULL, устройство будет установлено в ненастроенное состояние.

ConfigurationHandle

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

Interface

Задает массив переменной длины USBD_INTERFACE_INFORMATION структур, каждая из которых описывает интерфейс, поддерживаемый выбранной конфигурацией.

Перед отправкой запроса драйверу контроллера узла драйвер может выбрать альтернативный параметр для одного или нескольких интерфейсов, содержащихся в этом массиве, задав элементы структуры USBD_INTERFACE_INFORMATION для этого интерфейса.

По возвращении из драйвера контроллера узла этот элемент содержит структуру USBD_INTERFACE_INFORMATION с данными, описывающими возможности и формат конечных точек в этом интерфейсе.

URB_FUNCTION_SELECT_CONFIGURATION URB состоит из структуры _URB_SELECT_CONFIGURATION , за которой следует последовательность массива USBD_INTERFACE_INFORMATION структур переменной длины, каждый элемент массива для каждого уникального номера интерфейса в конфигурации. Клиентские драйверы должны выделять достаточно памяти, чтобы содержать одну USBD_PIPE_INFORMATION структуру для каждой конечной точки в выбранных интерфейсах.

Драйверы могут использовать подпрограмму службы USBD_CreateConfigurationRequestEx для выделения URB.

Другие элементы, которые являются частью этой структуры, но не описаны здесь, должны рассматриваться как непрозрачные и считаться зарезервированными для использования системой.