---

Data Handlers

Certain data handlers support scheduling reads in the future. These data handlers implement DataHTask, so that they will have an opportunity to start that read sometime later. These data handlers can throttle back the calls to DataHTask by implementing DataHSetIdleManager, and using the Idle Manager calls to say when they want to be idled next.

DataHSetIdleManager

Gives an Idle Manager object to a data handler, so it can report its idling needs.

DataHSetIdleManager (DataHandler dh,
   IdleManager im);

Parameters

dh

A data handler component instance.

im

An idle manager.

Discussion

This routine must be implemented by a data handler that wants to report its idling needs.

Introduced in QuickTime 6.

Availability

• Available in Mac OS X v10.2 and later.

Declared In

QuickTimeComponents.h

What To Do Next

After receiving an idle manager by means of the above calls, a data handler can call the following routines to tell QuickTime when they need to be idled next:

• QTIdleManagerSetNextIdleTime

• QTIdleManagerSetNextIdleTimeNever

• QTIdleManagerSetNextIdleTimeNow

• QTIdleManagerSetNextIdleTimeDelta

---