CDI_Object_Update
Allows the CDM to update device object information.
LONG CDI_Object_Update ( LONG cdmOSHandle, LONG cdiBindHandle, struct UpdateInfoStruct *info, LONG infoSize, LONG reasonFlag );
The following table lists return values and descriptions.
CDI_Object_Update is used by a CDM to update device object information with NWPA. Typically, object updating is done when the CDM needs to deactivate a device or put in capacity, unit size, or block size information for a removable device on a mount.
Although it is not a specific NWPA requirement, it is good practice for a CDM to store the device object information for each device it supports into a local structure.
Whenever device information is updated, the update information should also be mirrored into the local storage structure. Doing this allows the CDM to know the current operational information for each device it supports. However, to save NWPA time and overhead in performing the update, the CDM should allocate a reusable UpdateInfoStruct to use exclusively as an input parameter to CDI_Object_Update. Then, when an update is necessary, the CDM should do the following:
NOTE:Updated field values should be mirrored into the corresponding fields of device's local storage structure.