Admin Production ni-theme
Current Publication

ReadFromPhysicalMemory

LabWindows/CVI

ReadFromPhysicalMemory

int ReadFromPhysicalMemory (unsigned int physicalAddress, void *destinationBuffer, unsigned int numberOfBytes);

Purpose

Note Note  This function is obsolete and always returns an error code of 0, which indicates failure.

Copies the contents of a region of physical memory into the specified buffer.

ReadFromPhysicalMemory does not check whether the memory actually exists. If the memory does not exist, ReadFromPhysicalMemory returns the success value but does not read data.

Note    ReadFromPhysicalMemory requires the LabWindows/CVI low-level support driver. LabWindows/CVI loads the driver at startup if it is on disk. You can check whether LabWindows/CVI loaded the driver at startup by calling CVILowLevelSupportDriverLoaded.

The low-level support driver is not supported on 64-bit systems. Only applications running with administrator privileges on 32-bit systems can load the low-level support driver.

Parameters

Input
Name Type Description
physicalAddress unsigned int Physical address to read from.

No restrictions exist on the address, which can be below or above 1 MB.
destinationBuffer void * Buffer into which to copy the physical memory.
numberOfBytes unsigned int Number of bytes to copy from physical memory.

Return Value

Name Type Description
status int Indicates whether the function succeeded.

Code Description
1 Success.
0 Operating system reported failure, or low-level support driver not loaded.

Additional Information

Library: Utility Library

Include file: utility.h

LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later