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

Статья
02/07/2025

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

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

Синтаксис

void WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG(
  [out] PWDF_USB_DEVICE_SELECT_CONFIG_PARAMS Params
);

Параметры

[out] Params

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

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

Никакой

Замечания

Функция WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG ноль структуры WDF_USB_DEVICE_SELECT_CONFIG_PARAMS и задает элемент размер размеру структуры. Он также задает элемент типа для WdfUsbTargetDeviceSelectConfigTypeDeconfig.

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

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_MULTIPLE_INTERFACES
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_URB

Примеры

В следующем примере кода инициализируется структура WDF_USB_DEVICE_SELECT_CONFIG_PARAMS, а затем вызывается WdfUsbTargetDeviceSelectConfig для отмены настройки устройства.

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS configParams;
NTSTATUS status;

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG(&configParams);
Status = WdfUsbTargetDeviceSelectConfig(
                                        UsbDevice,
                                        WDF_NO_OBJECT_ATTRIBUTES,
                                        &configParams
                                        );

Требования

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