ADIC Digital Camera 601355 Rev A User Manual

Page of 1192
API Guide
2-766
API Functions
601355 Rev A
82 }
Notes
The API must be initialized with a call to 
VS_Initialize
 
before this function can be executed.
VolServ does not generate intermediate status in response to a 
Modify Media request. 
VSCMD_ModifyMedia
 does not trigger any MediaClass 
callbacks from VolServ.
The 
VSID_FIELD_LIST,
 
VSID_MEDIA_STAT_OPTION_LIST
, and 
VSID_MEDIA_STAT_VALUE_LIST
 parameters require that 
two arguments be passed instead of one.
Number of items in the field, media stat, and media stat option 
lists must be equal.
If the 
VSID_MODMEDIA_OPTION
 is set to 
VSE_MODMEDIA_OPTION_REPLACE
, the current medium 
statistics are deleted, and the statistics given in the 
VSID_MEDIA_STAT_VALUE_LIST
 are added for the 
medium.
If the 
VSID_MODMEDIA_OPTION
 is set to 
VSE_MODMEDIA_OPTION_DELETE
, the field, stat option, 
and stat value lists are ignored, and all current medium statistics 
are deleted.
A medium may have as many field values as desired. However, 
only up to 16 can be updated at one time through the Modify 
Media command.
All medium statistics are kept in character format. If numeric 
values are to be kept, they should be left-filled with zeros for 
proper comparisons.