viMemFreeEx

Agilent VISA.NET

viMemFreeEx

Syntax

viMemFreeEx(ViSession vi, ViBusAddress64 offset64);   [VISA 4.0 and later]

Description

Note: viMemFreeEx is implemented for PXI MEMACC resources only. It is not implemented for VXI and VXI-GPIB MEMACC resources.

This VISA 4.0 (and later) function frees the memory previously allocated using viMemAllocEx. 

Parameters

Name

Dir

Type

Description

vi

IN

ViSession

Unique logical identifier to a session.

offset64

IN

ViBusAddress64

Specifies the memory previously allocated with viMemAllocEx.

Return Values

Type ViStatus

This is the function return status. It returns either a completion code or an error code as follows.

   

Completion Code

Description

VI_SUCCESS

Operation completed successfully.

   

Error Codes

Description

VI_ERROR_INV_OFFSET

Invalid offset specified.

VI_ERROR_INV_SESSION
VI_ERROR_INV_OBJECT

The given session or object reference is invalid (both are the same value).

VI_ERROR_NSUP_OPER

The given vi does not support this operation.

VI_ERROR_WINDOW_NMAPPED

The specified offset is currently in use by viMapAddress.

See Also

viMemAllocEx