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

Статья
02/07/2025

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

Функция WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB инициализирует структуру WDF_USB_INTERFACE_SELECT_SETTING_PARAMS, чтобы драйвер может выбрать USB-интерфейс, указав URB.

Синтаксис

void WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB(
  [out] PWDF_USB_INTERFACE_SELECT_SETTING_PARAMS Params,
  [in]  PURB                                     Urb
);

Параметры

[out] Params

Указатель на структуру, выделенную драйвером WDF_USB_INTERFACE_SELECT_SETTING_PARAMS.

[in] Urb

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

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

Никакой

Замечания

Функция WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB ноль структуры WDF_USB_INTERFACE_SELECT_SETTING_PARAMS и задает для элемента размер размер структуры. Он также задает элемент TypeWdfUsbInterfaceSelectSettingTypeUrb и задает элемент Types.Urb.Urb.Urb значение, указанное указателем urb.

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

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB

Примеры

Следующий пример кода инициализирует структуру URB, а затем использует структуру в качестве входных данных для WdfUsbInterfaceSelectSetting.

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS  selectSettingParams;
URB  urb;
NTSTATUS  Status;

//
// Initialize the URB structure here.
//
...

//
// Initialize the WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 
// structure and call WdfUsbInterfaceSelectSetting.
//
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB(
                                      &selectSettingParams,
                                      &urb
                                      );

Status = WdfUsbInterfaceSelectSetting(
                                      UsbInterface,
                                      WDF_NO_OBJECT_ATTRIBUTES,
                                      &selectSettingParams
                                      );

Требования

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

См. также

URB

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING

Поделиться через