IBM Visualization Data Explorer Programmer's Reference

[ Bottom of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]

DXAddTask

Function Adds a task to the current task Group.

Syntax


#include <dx/dx.h>
Error DXAddTask(Error(*proc)(Pointer), Pointer arg, int size, double work)

.

Functional Details The task to be added is defined by the following parameters:

proc

A pointer to a function that performs the task. It takes one argument of type Pointer.

arg

A pointer to an argument block.

size

The size of the argument block in bytes. If size is nonzero, the argument block is copied. Otherwise, the value of arg is passed to proc without copying, which is useful for passing integers or Objects.

work

The estimated amount of time required by the task in arbitrary units.

Tasks are executed, in parallel if possible, by DXExecuteTaskGroup. Executing a task consists of calling (*proc)(arg). To facilitate load balancing, tasks are executed in order of decreasing work estimates. Once DXExecuteTaskGroup has been called, additional tasks can be created only from other tasks in the current task Group, and they are run as soon as possible, without regard to work or the status of the original tasks.

Return Value Returns OK or returns ERROR and sets an error code.

See Also DXAbortTaskGroup, DXCreateTaskGroup, DXExecuteTaskGroup, DXProcessorId, DXProcessors

13.8 , "Parallelism".


[ Top of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration Guide ]

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]


[IBM Home Page | Order | Search | Contact IBM | Legal ]