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

Статья
02/27/2024

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

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

Синтаксис

void WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR(
  [out] PWDF_USB_INTERFACE_SELECT_SETTING_PARAMS Params,
  [in]  PUSB_INTERFACE_DESCRIPTOR                Interface
);

Параметры

[out] Params

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

[in] Interface

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

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

None

Remarks

Функция WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR обнуляет структуру WDF_USB_INTERFACE_SELECT_SETTING_PARAMS и задает для ее члена Size размер структуры. Он также задает для элемента Type значение WdfUsbInterfaceSelectSettingTypeDescriptor и задает для элемента Types.Descriptor.InterfaceDescriptor значение указателя интерфейса .

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

Примеры

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

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS  selectSettingParams;
USB_INTERFACE_DESCRIPTOR  interfaceDescriptor;
NTSTATUS  Status;

//
// Initialize the USB_INTERFACE_DESCRIPTOR structure here.
//
...

//
// Initialize the WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 
// structure and call WdfUsbInterfaceSelectSetting.
//
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR(
                                      &selectSettingParams,
                                      &interfaceDescriptor
                                      );

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

Требования

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

См. также раздел

USB_INTERFACE_DESCRIPTOR

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB

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