WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG function (wdfusb.h)

Article
02/22/2024

[Applies to KMDF and UMDF]

The WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG function initializes a WDF_USB_DEVICE_SELECT_CONFIG_PARAMS structure so that a driver can deconfigure a USB device.

Syntax

void WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG(
  [out] PWDF_USB_DEVICE_SELECT_CONFIG_PARAMS Params
);

Parameters

[out] Params

A pointer to a driver-allocated WDF_USB_DEVICE_SELECT_CONFIG_PARAMS structure.

Return value

None

Remarks

The WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG function zeros the WDF_USB_DEVICE_SELECT_CONFIG_PARAMS structure and sets the Size member to the size of the structure. It also sets the Type member to WdfUsbTargetDeviceSelectConfigTypeDeconfig.

To initialize a WDF_USB_DEVICE_SELECT_CONFIG_PARAMS structure, the driver must call one of the following functions:

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

Examples

The following code example initializes a WDF_USB_DEVICE_SELECT_CONFIG_PARAMS structure and then calls WdfUsbTargetDeviceSelectConfig to deconfigure a device.

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
                                        );

Requirements

Requirement	Value
Target Platform	Universal
Minimum KMDF version	1.0
Minimum UMDF version	2.0
Header	wdfusb.h (include Wdfusb.h)