capSetCallbackOnYield-Makro (vfw.h)
Das Makro capSetCallbackOnYield legt eine Rückruffunktion in der Anwendung fest. AVICap ruft diese Prozedur auf, wenn das Erfassungsfenster während der Streamingerfassung ergebnisset. Sie können dieses Makro verwenden oder explizit die WM_CAP_SET_CALLBACK_YIELD-Nachricht aufrufen.
Syntax
void capSetCallbackOnYield(
hwnd,
fpProc
);
Parameter
hwnd
Handle für ein Erfassungsfenster.
fpProc
Zeiger auf die Yield-Rückruffunktion vom Typ capYieldCallback. Geben Sie NULL für diesen Parameter an, um eine zuvor installierte Yield-Rückruffunktion zu deaktivieren.
Rückgabewert
Keine
Bemerkungen
Anwendungen können optional eine Renditerückruffunktion festlegen. Die Renditerückruffunktion wird mindestens einmal für jeden Videoframe aufgerufen, der während der Streamingaufnahme aufgenommen wurde. Wenn eine Renditerückruffunktion installiert ist, wird sie unabhängig vom Status des fYield-Elements der CAPTUREPARMS-Struktur aufgerufen.
Wenn die Renditerückruffunktion verwendet wird, muss sie vor dem Starten der Erfassungssitzung installiert werden und muss für die Dauer der Sitzung aktiviert bleiben. Sie kann deaktiviert werden, nachdem die Streamingerfassung beendet wurde.
Anwendungen führen in der Regel eine Art von Nachrichtenverarbeitung in der Rückruffunktion aus, die aus einer PeekMessage-, TranslateMessage- und DispatchMessage-Schleife besteht, wie in der Nachrichtenschleife einer WinMain-Funktion . Die Renditerückruffunktion muss auch Nachrichten filtern und entfernen, die zu Problemen bei der Wiedereinreichung führen können.
Eine Anwendung gibt in der Regel TRUE in der Yield-Prozedur zurück, um die Streamingerfassung fortzusetzen. Wenn eine Renditerückruffunktion FALSE zurückgibt, beendet das Erfassungsfenster den Erfassungsprozess.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |