ReadFromPhysicalMemoryEx
- Updated2023-02-21
- 2 minute(s) read
ReadFromPhysicalMemoryEx
int ReadFromPhysicalMemoryEx (unsigned int physicalAddress, void *destinationBuffer, unsigned int numberOfBytes, int bytesAtATime);
Purpose
 |
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.
The function can copy the data in units of 1, 2, or 4 bytes at a time. ReadFromPhysicalMemoryEx does not check whether the memory actually exists. If the memory does not exist, ReadFromPhysicalMemoryEx returns the success value but does not read data.
|
Note ReadFromPhysicalMemoryEx 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 above or below 1 MB. |
| destinationBuffer | void * | Buffer into which to copy the physical memory. |
| numberOfBytes | unsigned int | Number of bytes to copy from physical memory. numberOfBytes must be a multiple of bytesAtATime. |
| bytesAtATime | int | Unit size in which to copy the data. bytesAtATime can be 1, 2, or 4 bytes. |
Return Value
| Name | Type | Description | ||||||
| status | int | Indicates whether the function succeeded.
|
Additional Information
Library: Utility Library
Include file: utility.h
LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later