capSetCallbackOnYield 宏 (vfw.h)

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

語法

void capSetCallbackOnYield(
   hwnd,
   fpProc
);

hwnd

擷取視窗的句柄。

fpProc

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

無

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

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

應用程式通常會在由 PeekMessage、TranslateMessage、DispatchMessage 循環組成的回調函式中執行某種類型的訊息處理，如同 WinMain 函式的訊息循環一樣。 yield 回呼函式也必須篩選和移除可能導致重新進入問題的訊息。

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

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	vfw.h