Freigeben über


capSetCallbackOnCapControl-Makro (vfw.h)

Das Makro capSetCallbackOnCapControl legt eine Rückruffunktion in der Anwendung fest, die ihr eine präzise Aufzeichnungssteuerung ermöglicht. Sie können dieses Makro verwenden oder explizit die WM_CAP_SET_CALLBACK_CAPCONTROL-Nachricht aufrufen.

Syntax

void capSetCallbackOnCapControl(
   hwnd,
   fpProc
);

Parameter

hwnd

Handle für ein Erfassungsfenster.

fpProc

Zeiger auf die Rückruffunktion vom Typ capControlCallback . Geben Sie NULL für diesen Parameter an, um eine zuvor installierte Rückruffunktion zu deaktivieren.

Rückgabewert

Keine

Bemerkungen

Eine einzelne Rückruffunktion wird verwendet, um der Anwendung eine präzise Kontrolle über die Momente zu geben, in denen die Streamingerfassung beginnt und abgeschlossen wird. Das Erfassungsfenster ruft zuerst die Prozedur auf, wobei nState auf CONTROLCALLBACK_PREROLL festgelegt ist, nachdem alle Puffer zugeordnet und alle anderen Erfassungsvorbereitungen abgeschlossen wurden. Dies gibt der Anwendung die Möglichkeit, Videoquellen vorab zu registrieren, die von der Rückruffunktion genau zu dem Zeitpunkt zurückgegeben wird, zu dem die Aufzeichnung beginnt. Der Rückgabewert TRUE aus der Rückruffunktion setzt die Erfassung fort, und der Rückgabewert FALSE bricht die Erfassung ab. Nach Beginn der Erfassung wird diese Rückruffunktion häufig aufgerufen, wobei nState auf CONTROLCALLBACK_CAPTURING festgelegt ist, damit die Anwendung die Erfassung beenden kann, indem FALSE zurückgegeben wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vfw.h

Weitere Informationen

Videoaufnahme

Videoaufnahmemakros

WM_CAP_SET_CALLBACK_CAPCONTROL

capControlCallback