CAMSchedule::AddAdvisePacket

  • Article

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

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 Values

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

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.