ARPluginCreateInstance

Description

This optional function creates a plug-in instance and can also create instance-specific data. Simple plug-ins might not need to define this function because they do not need to create instance-specific data.

The plug-in server uses multiple threads for improved scalability or throughput. A plug-in can use this function and its context object argument to make instance-specific data thread-safe.

Synopsis

#include "arplugin.h"

int ARPluginCreateInstance(
void **object,
ARStatusList *status)

Return arguments

object

Pointer to the plug-in instance that this function creates, if any. The other functions have a parameter that points to this object to establish the context for the function, so, to be thread-safe, this object must contain all instance-specific data.

status

List of zero or more notes, warnings, or errors generated from a call to this function. For a description of all possible values, see Error-checking.