DBS9900 User’s Manual
DBS9900 Driver Software
5-59
82-28993 Revision 01
5.7.2
Mask Write to Instrument
an9900_maskWriteInst
This function writes data to an instrument register to modify device settings. It performs a read
and then a write to preserve actual values.
Function Prototype
ViStatus
an9900_maskWriteInst
( ViSession
instrumentHandle
,
ViUInt16
registerNumber
,
ViUInt16
mask
,
ViUInt16
value
);
an9900_maskWriteInst
Parameters
Variable Type Description
<INPUT>
instrumentHandle
ViSession
This control accepts the Instrument Handle returned by the Initialize function to
select the desired instrument driver session.
registerNumber
ViUInt16
Specifies which register is to be written.
Valid range: 0x00 – 0x3F (Default value = 0x00).
mask
ViUInt16
Masks the data (in hex) to write to a register.
Valid range: 0x00 – 0xFF (Default value = 0x00).
value
ViUInt16
Writes data (in hex0 to a register).
Valid range: 0x00 – 0xFFFF (Default value = 0x00).
<OUTPUT>
None None
None
<RETURN>
= 0
> 0
< 0
“VI_SUCCESS”
Warning: The function completed, but an exception condition occurred which
may require attention.
Error: The function did not complete successfully.
NOTE: Use the an902_error_message() function to get a textual description of
errors and warnings.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com