National Instruments 320682C Musical Toy Instrument User Manual


 
Utility Library Chapter 8
LabWindows/CVI Standard Libraries 8-58 © National Instruments Corporation
ReadFromPhysicalMemoryEx
int
status
=
ReadFromPhysicalMemoryEx
(unsigned int
physicalAddress
,
void *
destinationBuffer
,
unsigned
int
numberOfBytes
,
int
bytesAtATime
);
Note:
This function is available only in the Windows version of LabWindows/CVI
.
Purpose
This function copies the contents of a region of physical memory into the specified buffer. It can
copy the data in units of 1, 2, or 4 bytes at a time.
The function does not check whether the memory actually exists. If the memory does not exist,
the success value is returned but no data is read.
Note:
For you to be able to use this function under Windows 95 or NT, the LabWindows/CVI
low-level support driver must be loaded.
Parameters
Input
physicalAddress
unsigned
integer
The physical address to read from. There are
no restrictions on the address; it can be above
or below 1 MB.
destinationBuffer
void pointer The buffer into which the physical memory is
copied.
numberOfBytes
unsigned
integer
The number of bytes to copy from physical
memory.
bytesAtATime
integer The unit size in which to copy the data. Can be
1, 2, or 4.
Return Value
status
integer Indicates whether the function succeeded.
Return Codes
1 Success.
0 Failure reported by operating system, or low-level support driver not loaded, or
numberOfBytes
is not a multiple of
bytesAtATime
, or
invalid value for
bytesAtATime
.
Parameter Discussion
numberOfBytes
must be a multiple of
bytesAtATime
.