INtime® 3.1 Software - tenAsys

INtime 3.1 Software
Object directories
The object directory provides a rendezvous mechanism between RT threads or between
an RT thread and a Windows thread in an INtime application. An RT or Windows
process can catalog objects it wants to share. Other processes can wait for an object to
be cataloged.
These system calls manage RT object directories. Objects may be cataloged, looked up,
and uncataloged. The default directory is the one for the current process. Handles for
the other processes may be obtained using the GetRtThreadHandles call. Catalog names
may be up to 12 characters long and are case-sensitive.
NTX calls
System call
ntxLookupNtxHandle
ntxImportRtHandle
ntxCatalogRtHandle
ntxUncatalogRtHandle
ntxGetRootRtProcess
ntxGetType
Description
Looks up a name-to-handle association. Given a name, an RT or
Windows application can look up the handle associated with it.
Obtains an NTXHANDLE corresponding to an RTHANDLE.
Creates a name-to-handle association in the object directory of
the RT process specified in the call.
Removes the name-to-handle association in the object directory
of the RT process specified in the call.
Obtains the root RT process handle for the NTX location
specified in the call.
Checks the RT object’s type.
High-level calls
System call
CatalogRtHandle
LookupRtHandle
UncatalogRtHandle
InspectRtProcessDirectory
GetRtHandleType
GetRtHandleTypeEx
Description
Creates a name-to-handle association in the object directory of
the RT process specified in the call.
Searches the given process’ object directory for a given name
and returns the object handle, if found.
Removes an entry from a process’ object directory.
Returns the contents of a process’ object directory.
Returns a value indicating the type of an RT object. The handle
must be for a valid RT object.
120