meiControlExtMemAvail

Declaration

	long meiControlExtMemAvail(MPIControl control, long *size)
	Required Header: stdmei.h

Description

meiControlExtMemAvail gets the amount of external memory available on an XMP-Series controller. It puts the number of words (8 bit) in the location pointed to by size. Since the XMP is a 32 bit controller, the number of 32 bit words available is equal to the value of size divided by 4. The value of size is useful for setting things that use the external memory, such as the Recorder.

control	a handle to the Control object
*size	a pointer to the available memory words returned by the method

Return Values
MPIMessageOK

Sample Code


Example:

/* Prints the size of the available external memory size */
void printExternalMemorySize(MPIControl control)
{
    long returnValue;
    long size;

    returnValue = meiControlExtMemAvail(control, &size);

    msgCHECK(returnValue);

    printf("size %d (8 bit), %d (32 bit)", size, size / 4);
}

Output:

C:\out\extmemavail\Debug>extmemavail
size 238008 (8 bit), 59502 (32 bit)