mpiControlAccess

Declaration

MPI_RESULT
   mpiControlAccess(MPIControl           *control,
                    MPIControlType        type,
                    MPIControlAddress     *address);

 

Required Header: stdmpi.h

Change History: Added in 04.00.

Description

mpiControlAccess creates a Control object of the specified type and type-specific address. ControlAccess is the equivalent of a C++ constructor. mpiControlAccess establishes communication with the motion controller hardware, but does NOT initialize SynqNet networks connected to the controller. Controller communication can occur through direct memory access, device driver, or remote by using client/server.

mpiControlAccess is equivalent to mpiControlCreate without SynqNet initialization. For more information, see mpiControlCreate for usage details.

*control A pointer to a control object handle.
type The type of communication to access the controller hardware. Specifying MPIControlTypeDEFAULT applies MPIControlTypeDEVICE.
*address A pointer to a controller address structure. The address structure identifies the controller.  A controller can be local, remote, or a file containing a controller’s memory snapshot.
Return Values
MPIMessageOK
MPIControlMessageLIBRARY_VERSION
MPIControlMessageCONTROL_INVALID
MPIControlMessageTYPE_INVALID
MPIControlMessageCONTROL_NUMBER_INVALID
MPIControlMessageFIRMWARE_INVALID
MPIControlMessageSYNQNET_STATE
MPIPacketMessageADDRESS_INVALID
MPIPlatformMessageDEVICE_INVALID
MPIPlatformMessageDEVICE_MAP_ERROR
MPISynqNetMessageSTATE_ERROR

See Also

mpiControlCreate