Starts, configures, and terminates a session with the HOOPS Exchange Library. More...
Typedefs | |
typedef A3DStatus(* | PFA3DDisableHandleSIGSEGV )() |
Disables internal SIGSEGV handling (Linux only) More... | |
typedef A3DStatus(* | PFA3DDllGetVersion )(A3DInt32 *piMajorVersion, A3DInt32 *piMinorVersion) |
Gets the version identifiers for the currently installed HOOPS Exchange Library. More... | |
typedef A3DStatus(* | PFA3DDllInitialize )(A3DInt32 iMajorVersion, A3DInt32 iMinorVersion) |
Starts a session with the HOOPS Exchange Library. More... | |
typedef A3DStatus(* | PFA3DDllIsInitialized )() |
Gets the status of the library initialization HOOPS Exchange Library. More... | |
typedef A3DStatus(* | PFA3DDllTerminate )() |
Terminates a session with the HOOPS Exchange Library. More... | |
Detailed Description
Starts, configures, and terminates a session with the HOOPS Exchange Library.
The functions in this section start and terminate a session with the HOOPS Exchange Library.
Typedef Documentation
Starts a session with the HOOPS Exchange Library.
This function initializes the internal structures in the HOOPS Exchange Library.
- Version
- 2.0
- Parameters
-
iMajorVersion The major version of the HOOPS Exchange. Set this value to A3D_DLL_MAJORVERSION iMinorVersion The minor version of the HOOPS Exchange. Set this value to A3D_DLL_MINORVERSION
- Warning
- You must call this function before calling any other functions in the HOOPS Exchange, with these exceptions:
- You can call A3DDllGetVersion anytime.
- To have the HOOPS Exchange Library produce an XML trace file, you must call A3DDllActivateXMLTrace before calling this function.
- Sample code
typedef A3DStatus( * PFA3DDisableHandleSIGSEGV)() |
Disables internal SIGSEGV handling (Linux only)
This function deactivates the handling of the SIGSEGV signal on Linux. By default, SIGSEGV is handled and an exception is thrown to return A3D_EXCEPTION.
- Warning
- You must call this function before A3DDllInitialize
- Returns
- A3D_SUCCESS
-
A3D_ERROR if not on Linux
typedef A3DStatus( * PFA3DDllTerminate)() |
Terminates a session with the HOOPS Exchange Library.
This function terminates a session with the HOOPS Exchange Library. It deallocates memory it has previously allocated for its internal use.
You must call this function to end a session with the HOOPS Exchange Library.
- Version
- 2.0
- Warning
- You can call this function only after successfully calling A3DDllInitialize.
- When your process is done with A3DLIBS.dll (after calling A3DDllTerminate), you MUST unload that DLL, as shown in the sample code for A3DDllInitialize. Unloading the DLL helps to avoid conflicts that can occur when multiple processes use A3DLIBS.dll.
- Processes must avoid parallel access to A3DLIBS.dll.
Gets the version identifiers for the currently installed HOOPS Exchange Library.
This function returns the version of the currently installed HOOPS Exchange Library. Use these version identifiers to determine whether that library is compatible with your application. The value returned through the piMajorVersion
argument is identical to the Acrobat version identifier. The value returned through the piMinorVersion
argument is specific to the HOOPS Exchange Library.
To ensure compatibility, the A3D_DLL_MAJORVERSION must be identical to the major version of currently installed HOOPS Exchange Library, and the A3D_DLL_MINORVERSION must be less than or equal to the minor version of the currently installed HOOPS Exchange Library.
You can call A3DDllGetVersion anytime, even before calling A3DDllInitialize and after calling A3DDllTerminate. This function does not allocate memory.
- Version
- 2.0
- Returns
- A3D_SUCCESS
typedef A3DStatus( * PFA3DDllIsInitialized)() |
Gets the status of the library initialization HOOPS Exchange Library.
This function returns the status of the library initialization HOOPS Exchange Library.
This function does not allocate memory.
- Version
- 11.0
- Returns
- A3D_SUCCESS