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

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

See also

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS