ICDrawSetTime

  • Article

The ICDrawSetTime macro provides synchronization information to a rendering driver that handles the timing of drawing frames. The synchronization information is the sample number of the frame to draw. You can use this macro or explicitly call the ICM_DRAW_SETTIME message.

DWORD ICDrawSetTime(
 hic,     lpTime  );

Parameters

hic

Handle to a driver.

lpTime

Sample number of the frame to render.

Return Values

Returns ICERR_OK if successful or an error otherwise.

Remarks

Typically, the driver compares the specified value with the frame number associated with the time of its internal clock and attempts to synchronize the two if the difference is significant.

Use this message when the hardware performs its own asynchronous decompression, timing, and drawing, and the hardware relies on an external synchronization signal (the hardware is not being used as the synchronization master).

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Vfw.h.

See Also

Video Compression Manager, Video Compression Macros, ICM_DRAW_SETTIME