WM_CAP_SET_CALLBACK_YIELD Nachricht

Die WM_CAP_SET_CALLBACK_YIELD-Nachricht legt eine Rückruffunktion in der Anwendung fest. AVICap ruft diese Prozedur auf, wenn das Erfassungsfenster während der Streamingaufnahme nachgibt. Sie können diese Nachricht explizit oder mithilfe des Makros capSetCallbackOnYield senden.

WM_CAP_SET_CALLBACK_YIELD 
wParam = (WPARAM) 0; 
lParam = (LPARAM) (LPVOID) (fpProc); 

Parameter

fpProc

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

Rückgabewert

Gibt TRUE zurück, wenn erfolgreich oder FALSE , wenn die Streamingaufnahme oder eine Einzelframeaufnahmesitzung ausgeführt wird.

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 Zustand des fYield-Members 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 Streamingaufzeichnung beendet ist.

Anwendungen führen in der Regel eine Art von Nachrichtenverarbeitung in der Rückruffunktion aus einer PeekMessage-, TranslateMessage- und DispatchMessage-Schleife wie in der Nachrichtenschleife einer WinMain-Funktion durch. Die Renditerückruffunktion muss auch Nachrichten filtern und entfernen, die Zustellprobleme verursachen können.

Eine Anwendung gibt in der Regel TRUE in der Ertragsprozedur 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]
Header	Vfw.h

Weitere Informationen

Videoaufnahme

Videoaufzeichnungsnachrichten