Compartir a través de


Método CAMSchedule.AddAdvisePacket

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El AddAdvisePacket método agrega una solicitud de aviso a la lista de solicitudes pendientes.

Sintaxis

DWORD_PTR AddAdvisePacket(
  [ref] const REFERENCE_TIME &time1,
  [ref] const REFERENCE_TIME &time2,
              HANDLE         hNotify,
              BOOL           bPeriodic
);

Parámetros

time1 [ref]

Hora solicitada para el aviso.

time2 [ref]

Para las solicitudes periódicas de aviso, el tiempo entre las notificaciones. Este parámetro se omite si bPeriodic es FALSE.

hNotify

Controlar en un semáforo si bPeriodic es TRUE o controlar en un evento si bPeriodic es FALSE.

bPeriodic

Valor booleano que especifica si se va a agregar una notificación periódica o una notificación de una sola captura. Si es TRUE, la notificación es periódica; el parámetro time2 especifica el tiempo entre las notificaciones. Si es FALSE, la notificación solo se produce una vez.

Valor devuelto

Devuelve un identificador para la solicitud de aviso (la "cookie"). Si se produce un error en el método, el valor devuelto es cero.

Requisitos

Requisito Value
Encabezado
Dsschedule.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

CAMSchedule (clase)