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

Статья
02/29/2024

[Относится к KMDF и UMDF]

Функция WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR инициализирует структуру WDF_USB_CONTROL_SETUP_PACKET для передачи элементов управления ЧЕРЕЗ USB.

Синтаксис

void WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR(
  [out] PWDF_USB_CONTROL_SETUP_PACKET Packet,
  [in]  WDF_USB_BMREQUEST_DIRECTION   Direction,
  [in]  WDF_USB_BMREQUEST_RECIPIENT   Recipient,
  [in]  BYTE                          Request,
  [in]  USHORT                        Value,
  [in]  USHORT                        Index
);

Параметры

[out] Packet

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

[in] Direction

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

[in] Recipient

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

[in] Request

Константа типа запроса, которая хранится в элементе Packet.bRequest структуры WDF_USB_CONTROL_SETUP_PACKET .

[in] Value

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

[in] Index

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

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

None

Remarks

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

Обнуляет структуру WDF_USB_CONTROL_SETUP_PACKET .
Задает для элемента Packet.bm.Request.Typeзначение BmRequestVendor.
Задает другие элементы структуры с помощью входных аргументов функции WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR .

Чтобы инициализировать структуру 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  controlSetupPacket;

WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR(
                                         &controlSetupPacket,
                                         BmRequestHostToDevice,
                                         BmRequestToDevice,
                                         USBFX2LK_REENUMERATE,
                                         0,
                                         0
                                         );

Требования

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