viPoke8, viPoke16, viPoke32, and viPoke64

Agilent VISA.NET

viPoke8, viPoke16, viPoke32, and viPoke64

Syntax

viPoke8(ViSession vi, ViAddr addr, ViUInt8 val8);

viPoke16(ViSession vi, ViAddr addr, ViUInt16 val16);

viPoke32(ViSession vi, ViAddr addr, ViUInt32 val32);

viPoke64(ViSession vi, ViAddr addr, ViUInt64 val64);  [VISA 4.0 and later]

Description

This function takes an 8-bit, 16-bit, 32-bit, or 64-bit value and stores its content to the address pointed to by addr. The address must be a valid memory address in the current process mapped by a previous viMapAddress call.

Note: ViAddr is defined as a void *. To do pointer arithmetic, you must cast this to an appropriate type (ViUInt8, ViUInt16, ViUInt32, or ViUInt64). Then, be sure the offset is correct for the type of pointer you are using. For example, (ViUInt8 *)addr + 4 points to the same location as (ViUInt16 *)addr + 2.

Parameters

Name

Dir

Type

Description

vi

IN

ViSession

Unique logical identifier to a session.

addr

IN

ViAddr

Specifies the destination address to store the value.

val8,
val16,
val32, or
val64

IN

ViUInt8,
ViUInt16,
ViUInt32, or
ViUInt64

Data read from bus (8 bits for viPoke8, 16 bits for viPoke16, 32 bits for viPoke32, and 64 bits for viPoke64).

Return Values

None

See Also

viPeek8, viPeek16, viPeek32, viPeek64, viMapAddress, viOut8, viOut16, viOut32, viOut64