функция WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE (wdfusb.h)

Статья
08/08/2023

[Применимо к KMDF и UMDF]

Функция WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE инициализирует структуру WDF_USB_CONTROL_SETUP_PACKET для передачи элементов управления USB, которая задает или очищает функцию устройства.

Синтаксис

void WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE(
  [out] PWDF_USB_CONTROL_SETUP_PACKET Packet,
  [in]  WDF_USB_BMREQUEST_RECIPIENT   BmRequestRecipient,
  [in]  USHORT                        FeatureSelector,
  [in]  USHORT                        Index,
  [in]  BOOLEAN                       SetFeature
);

Параметры

[out] Packet

Указатель на структуру WDF_USB_CONTROL_SETUP_PACKET .

[in] BmRequestRecipient

WDF_USB_BMREQUEST_RECIPIENT типизированное значение, хранящееся в элементе Packet.bm.Request.Recipient структуры WDF_USB_CONTROL_SETUP_PACKET.

[in] FeatureSelector

Значение конкретной функции, хранящееся в элементе Packet.wValue.Valueструктуры WDF_USB_CONTROL_SETUP_PACKET .

[in] Index

Значение индекса для конкретной функции, хранящееся в элементе Packet.wIndex.Value структуры WDF_USB_CONTROL_SETUP_PACKET .

[in] SetFeature

Логическое значение, которое, если значение TRUE, указывает, что будет задана указанная функция. Если значение РАВНО FALSE, указанная функция будет очищена.

Возвращаемое значение

None

Remarks

Функция WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE выполняет следующие действия.

Обнуляет структуру WDF_USB_CONTROL_SETUP_PACKET .
Задает для элемента Packet.bm.Request.Type значение BmRequestStandard.
Задает для элемента Packet.bm.Request.Dir значение BmRequestDeviceToDevice.
Задает для члена Packet.bRequest значение запроса set feature или clear feature на основе аргумента SetFeature .
Задает другие члены структуры с помощью входных аргументов функции WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE .

Чтобы инициализировать структуру WDF_USB_CONTROL_SETUP_PACKET , драйвер должен вызвать одну из следующих функций:

WDF_USB_CONTROL_SETUP_PACKET_INIT
WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS
WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE
WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS
WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR

Примеры

В следующем примере кода инициализируется структура WDF_USB_CONTROL_SETUP_PACKET .

WDF_USB_CONTROL_SETUP_PACKET packet;

WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE(
                                          &packet,
                                          BMREQUEST_TO_DEVICE,
                                          USB_DEVICE_DESCRIPTOR_TYPE,
                                          0,
                                          FALSE
                                          );

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Минимальная версия UMDF	2,0
Верхняя часть	wdfusb.h (включая Wdfusb.h)