ProSoft Technology MVI69-ADM - Manual (Page 203)

MVI-ADM ♦ 'C' Programmable Backplane API Functions
'C' Programmable Application Development Module Developer's Guide
ProSoft Technology, Inc. Page 203 of 342
February 20, 2013
8.1 Backplane API Initialization Functions
MVIbp_Open
Syntax
int MVIbp_Open(MVIHANDLE *handle);
Parameters
handle Pointer to variable of type MVIHANDLE
Description
MVIbp_Open acquires access to the API and sets handle to a unique ID that the
application uses in subsequent functions. This function must be called before any
of the other API functions can be used.
IMPORTANT: After the API has been opened, MVIbp_Close should always be called before
exiting the application.
Return Value
MVI_SUCCESS API was opened successfully
MVI_ERR_REOPEN API is already open
MVI_ERR_NODEVICE Backplane driver could not be accessed
Note: MVI_ERR_NODEVICE will be returned if the backplane device driver is not loaded.
Example
MVIHANDLE Handle;
if ( MVIbp_Open(&Handle) != MVI_SUCCESS) {
printf("Open failed!\n");
} else {
printf("Open succeeded\n");
}
See Also
MVIbp_Close (page 204)