Creates a DOFConnection that uses the specified configuration. The connection is associated with the DOF instance that creates it, and only that DOF can route operations through it (see DOF). This function may be used to create the following types of connections: This function may not be used to create the following types of connections:
For more information about these connection types, see DOFConnectionType. Connections do not connect automatically when created. After creating the connection, call DOFConnection_Connect or DOFConnection_BeginConnect. To disconnect temporarily, call DOFConnection_Disconnect. Disconnected connections can be reconnected using DOFConnection_Connect or DOFConnection_BeginConnect. When the DOFConnection is no longer needed, it must be destroyed. See DOFConnection_Destroy. Destroyed connections cannot be reconnected. The internal library tracks references to duplicate connections, so this function can safely be called multiple times with the same configuration without consuming extra resources. Such duplicate connections are frequently needed, especially by nodes that create connections dynamically in response to other function calls.
|