Share via

CAMSchedule::AddAdvisePacket

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Creates a new pending notification and adds it to the advise notification list.

Syntax

DWORD AddAdvisePacket(
  const REFERENCE_TIME & time1,
  const REFERENCE_TIME & time2,
  HANDLE hNotify,
  BOOL bPeriodic
);

Parameters

  • time1
    Time that the advise should take place.

  • time2
    Period between notifications.

    Ignored if bPeriodic is FALSE.

  • hNotify
    Notification mechanism.

    Either a semaphore handle (if bPeriodic is TRUE) or an event handle.

  • bPeriodic
    Flag that specifies whether the notification is sent repeatedly, or whether the notification is sent once.

    This can be one of the following values.

    Value Description

    TRUE

    This is a periodic timer that will fire every time2 units until canceled.

    FALSE

    This is a one-shot timer.

Return Value

Returns the advise token if successful, or zero if an error occurred.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later