capSetCallbackOnYield-Makro (vfw.h)

Das capSetCallbackOnYield-Makro legt eine Rückruffunktion in der Anwendung fest. AVICap ruft diese Prozedur auf, wenn das Aufnahmefenster während der Streamingaufnahme ergibt. Sie können dieses Makro verwenden oder die WM_CAP_SET_CALLBACK_YIELD Nachricht explizit aufrufen.

Syntax

BOOL capSetCallbackOnYield(
     hwnd,
     fpProc
);

Die Parameter

hwnd

Behandeln eines Aufnahmefensters.

fpProc

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

Rückgabewert

Typ: BOOL

Gibt WAHR zurück, wenn erfolgreich oder FALSCH , wenn die Streamingaufnahme oder eine Single-Frame-Aufnahmesitzung 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 erfasst wird. Wenn eine Renditerückruffunktion installiert ist, wird sie unabhängig vom Status des fYield-Elements der CAPTUREPARMS-Struktur aufgerufen.

Wenn die Ertragsrückruffunktion verwendet wird, muss sie vor dem Starten der Aufnahmesitzung installiert werden und muss für die Dauer der Sitzung aktiviert bleiben. Sie kann deaktiviert werden, nachdem die Streamingaufnahme beendet wurde.

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

Eine Anwendung gibt in der Regel TRUE im Ertragsverfahren zurück, um die Streamingaufnahme fortzusetzen. Wenn eine Renditerückruffunktion FALSCH zurückgibt, beendet das Aufnahmefenster den Aufnahmevorgang.

Anforderungen

Siehe auch

Videoaufnahmemakros