Share via


CAMSchedule::AddAdvisePacket (Compact 2013)

3/26/2014

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

Header

dshow.h,
Streams.h

Library

ole32.lib,
Ole32auth.lib,
Strmbase.lib,
Strmiids.lib,
uuid.lib

See Also

Reference

CAMSchedule Class