Freigeben über


CAMSchedule.AddAdvisePacket-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die AddAdvisePacket -Methode fügt der Liste der ausstehenden Anforderungen eine Empfehlungsanforderung hinzu.

Syntax

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

Parameter

time1 [ref]

Angeforderte Zeit für die Beratung.

time2 [ref]

Bei regelmäßigen Beratungsanfragen die Zeit zwischen Benachrichtigungen. Dieser Parameter wird ignoriert, wenn bPeriodicauf FALSE festgelegt ist.

hNotify

Handle für einen Semaphor, wenn bPeriodicTRUE ist, oder handle für ein Ereignis, wenn bPeriodicauf FALSE festgelegt ist.

bPeriodic

Boolescher Wert, der angibt, ob eine regelmäßige Benachrichtigung oder eine einmalige Benachrichtigung hinzugefügt werden soll. Wenn TRUE, erfolgt die Benachrichtigung regelmäßig; Der time2-Parameter gibt die Zeit zwischen Benachrichtigungen an. Bei FALSE erfolgt die Benachrichtigung nur einmal.

Rückgabewert

Gibt einen Bezeichner für die Empfehlungsanforderung (das "Cookie") zurück. Wenn die Methode fehlschlägt, ist der Rückgabewert null.

Anforderungen

Anforderung Wert
Header
Dsschedule.h (Einschließen von Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CAMSchedule-Klasse