NewDataAcq
Creates a new acquisition thread.
Synopsis
int32 NewDataAcq (AcqContextPtr *pCtx, char* fileName, long
deltaPriority)
Description
Creates a new acquisition thread for the specified stream file.
The task priority of the acquisition thread is calculated in relation to
the priority of its parent task. If deltaPriority is set to
zero, the thread has the same priority as its parent task.
Arguments
pCtx
- Pointer to where the acquisition context is returned.
fileName
- Name of the data stream file.
deltaPriority
- Change in task priority of the acquisition thread.
Return Value
- Value
- Error Condition
-
- (Value of
creatorStatus field in context block of new
acquisition thread)
-
- 0
- Could not allocate stack memory for new acquisition thread
-
kDSNoMemErr
- Could not allocate memory for the acquisition context
-
kDSNoSignalErr
- Could not allocate signal for thread initialization
-
kDSSignalErr
- Received incorrect initialization signal
-
- (Portfolio error code)
CreateItem() failed to create an item for the new
acquisition thread
-
See "Error Messages" in the 3DO Portfolio Reference Manual for a
listing of error messages returned by CreateItem().
Associated Files
DataAcq.h
See Also
CreateItem,
DisposeSCelSubscriber,
InitDataAcq