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

Статья
02/07/2025

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

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

Синтаксис

void WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS(
  [out] PWDF_USB_CONTROL_SETUP_PACKET Packet,
  [in]  WDF_USB_BMREQUEST_RECIPIENT   BmRequestRecipient,
  [in]  USHORT                        Index
);

Параметры

[out] Packet

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

[in] BmRequestRecipient

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

[in] Index

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

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

Никакой

Замечания

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

Ноль структуры WDF_USB_CONTROL_SETUP_PACKET.
Задает элемент packet.bm.Request.Type для BmRequestStandard.
Задает элемент Packet.bm.Request.DirBmRequestDeviceToHost.
Задает элемент Packet.bRequest значение запроса "получить состояние".
Задает элемент Packet.wValue.Value равным нулю.
Задает элемент Packet->Packet.wIndex.Value аргумент index.

Чтобы инициализировать структуру 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_GET_STATUS(
                                             &packet,
                                             BmRequestToDevice,
                                             0
                                             );

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	wdfusb.h (include Wdfusb.h)