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 |