Método CAMSchedule.AddAdvisePacket

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O AddAdvisePacket método adiciona uma solicitação de consultoria à lista de solicitações pendentes.

Sintaxe

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

Parâmetros

time1 [ref]

Tempo solicitado para o aviso.

time2 [ref]

Para solicitações de consultoria periódicas, o tempo entre as notificações. Esse parâmetro será ignorado se bPeriodic for FALSE.

hNotify

Manipule para um semáforo se bPeriodic for TRUE ou manipule para um evento se bPeriodic for FALSE.

bPeriodic

Valor booliano que especifica se uma notificação periódica ou uma notificação única deve ser adicionada. Se TRUE, a notificação será periódica; o parâmetro time2 especifica o tempo entre as notificações. Se FALSE, a notificação ocorrerá apenas uma vez.

Retornar valor

Retorna um identificador para a solicitação de aviso (o "cookie"). Se o método falhar, o valor retornado será zero.

Requisitos

Requisito Valor
parâmetro
Dsschedule.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CAMSchedule