Export (0) Print
Expand All

DIF_DESTROYPRIVATEDATA

A DIF_DESTROYPRIVATEDATA request directs a class installer to free any memory or resources it allocated and stored in the ClassInstallReserved field of the SP_DEVINSTALL_PARAMS structure.

When Sent

When Windows destroys a device information set or an SP_DEVINFO_DATA element, or when Windows discards its list of co-installers and class installer for a device.

Who Handles

Class Co-installer

Does not handle

Device Co-installer

Does not handle

Class Installer

Can handle

 

Installer Input

DeviceInfoSet

Supplies a handle to a device information set.

DeviceInfoData

Optionally supplies a pointer to an SP_DEVINFO_DATA structure that identifies a device in the device information set.

Device Installation Parameters

Device installation parameters (SP_DEVINSTALL_PARAMS) are associated with the DeviceInfoData, if specified, or with the DeviceInfoSet.

Class Installation Parameters

None

Installer Output

Device Installation Parameters

An installer can clear the ClassInstallReserved field in the device installation parameters (SP_DEVINSTALL_PARAMS).

Installer Return Value

A co-installer does not handle this DIF request. It simply returns NO_ERROR in its preprocessing pass.

A class installer typically returns ERROR_DI_DO_DEFAULT or a Win32 error code.

Default DIF Code Handler

None

Installer Operation

In response to a DIF_DESTROYPRIVATEDATA request a class installer frees any memory or resources it allocated and stored in the ClassInstallReserved field of the SP_DEVINSTALL_PARAMS structure.

Co-installers should not use the ClassInstallReserved field.

For more information about DIF codes, see Handling DIF Codes.

Requirements

Version

Supported in Microsoft Windows 2000 and later versions of Windows.

Header

Setupapi.h (include Setupapi.h)

See also

SP_DEVINFO_DATA
SP_DEVINSTALL_PARAMS

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft