Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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 bPeriodicis FALSE.

hNotify

Notification mechanism.

Either a semaphore handle (if bPeriodicis 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 time2units 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