LabWindows/CVI

Content Type
Programming Language
Current manual

WriteToPhysicalMemoryEx

WriteToPhysicalMemoryEx

int WriteToPhysicalMemoryEx (unsigned int physicalAddress, const void *sourceBuffer, unsigned int numberOfBytes, int bytesAtATime);

Purpose

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

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

The function can copy the data in units of 1, 2, or 4 bytes at a time. WriteToPhysicalMemoryEx does not check whether the memory actually exists. If the memory does not exist, WriteToPhysicalMemoryEx returns the success value but does not read any data.

Note    WriteToPhysicalMemoryEx 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 write to.

No restrictions exist on the address, which can be above or below 1 MB.
sourceBuffer const void * Buffer from which to copy the physical memory.
numberOfBytes unsigned int Number of bytes to copy to 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.

Code Description
1 Success.
0 Operating system reported failure, low-level support driver not loaded, numberOfBytes is not a multiple of bytesAtATime, or invalid value for bytesAtATime.

Additional Information

Library: Utility Library

Include file: utility.h

LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later

Was this information helpful?