SP_REMOVEDEVICE_PARAMS structure (setupapi.h)

Article
02/22/2024

An SP_REMOVEDEVICE_PARAMS structure corresponds to the DIF_REMOVE installation request.

Syntax

typedef struct _SP_REMOVEDEVICE_PARAMS {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  DWORD                  Scope;
  DWORD                  HwProfile;
} SP_REMOVEDEVICE_PARAMS, *PSP_REMOVEDEVICE_PARAMS;

Members

ClassInstallHeader

An install request header that contains the header size and the DIF code for the request. See SP_CLASSINSTALL_HEADER.

Scope

Flags that indicate the scope of the device removal. Can be one of the following values:

DI_REMOVEDEVICE_GLOBAL

Make this change in all hardware profiles. Remove information about the device from the registry.

DI_REMOVEDEVICE_CONFIGSPECIFIC

Make this change to only the hardware profile specified by HwProfile. this flag only applies to root-enumerated devices. When Windows removes the device from the last hardware profile in which it was configured, Windows performs a global removal.

HwProfile

The hardware profile ID for profile-specific changes. Zero specifies the current hardware profile.

Requirements

Requirement	Value
Header	setupapi.h (include Setupapi.h)