# 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`