capSetCallbackOnYield 巨集 （vfw.h）

capSetCallbackOnYield 巨集會在應用程式中設定回呼函式。 當擷取視窗在串流擷取期間產生時，AVICap 會呼叫此程式。 您可以使用這個巨集，或明確地呼叫 WM_CAP_SET_CALLBACK_YIELD 訊息。

語法

BOOL capSetCallbackOnYield(
     hwnd,
     fpProc
);

參數

hwnd

擷取視窗的句柄。

fpProc

capYieldCallback 類型的 yield 回呼函式指標。 指定 這個 參數的 NULL 以停用先前安裝的 yield 回呼函式。

返回值

類型： BOOL

如果串流擷取或單一畫面格擷取會話正在進行中，則會傳回 TRUE。

備註

應用程式可以選擇性地設定 yield 回調函式。 針對串流擷取期間擷取的每個視訊畫面，至少呼叫一次 yield 回調函式。 如果已安裝 yield 回呼函式，不論 CAPTUREPARMS 結構的 fYield 成員的狀態為何，都會呼叫它。

如果使用 yield 回呼函式，則必須在啟動擷取工作階段之前先安裝它，而且必須在會話持續期間保持啟用。 串流擷取結束時可以停用它。

應用程式通常會在回呼函式中執行某種類型的訊息處理，其中包含 PeekMessage、TranslateMessage、DispatchMessage 迴圈，如 WinMain 函式的訊息迴圈所示。 yield 回呼函式也必須篩選並移除可能導致重新進入問題的訊息。

應用程式通常會在產生程式中傳回 TRUE ，以繼續串流擷取。 如果 yield 回呼函式傳回 FALSE，擷取視窗會停止擷取程式。

需求

另請參閱

視訊擷取

視訊擷取巨集