messaggio WM_CAP_SET_CALLBACK_YIELD

Il messaggio WM_CAP_SET_CALLBACK_YIELD imposta una funzione di callback nell'applicazione. AVICap chiama questa procedura quando la finestra di acquisizione restituisce durante l'acquisizione di streaming. È possibile inviare questo messaggio in modo esplicito o usando la macro capSetCallbackOnYield .

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

Parametri

fpProc

Puntatore alla funzione di callback di rendimento, di tipo capYieldCallback. Specificare NULL per questo parametro per disabilitare una funzione di callback di rendimento installata in precedenza.

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE se l'acquisizione di streaming o una sessione di acquisizione a frame singolo è in corso.

Commenti

Le applicazioni possono facoltativamente impostare una funzione di callback di rendimento. La funzione di callback di rendimento viene chiamata almeno una volta per ogni fotogramma video acquisito durante l'acquisizione di streaming. Se viene installata una funzione di callback di rendimento, verrà chiamata indipendentemente dallo stato del membro fYield della struttura CAPTUREPARMS .

Se viene usata la funzione di callback di rendimento, deve essere installata prima di avviare la sessione di acquisizione e deve rimanere abilitata per la durata della sessione. Può essere disabilitato dopo la fine dell'acquisizione di streaming.

Le applicazioni in genere eseguono un tipo di elaborazione dei messaggi nella funzione di callback costituita da un ciclo PeekMessage, TranslateMessage, DispatchMessage , come nel ciclo di messaggi di una funzione WinMain . La funzione di callback di rendimento deve anche filtrare e rimuovere messaggi che possono causare problemi di reentrancy.

Un'applicazione restituisce in genere TRUE nella procedura di rendimento per continuare l'acquisizione di streaming. Se una funzione di callback di rendimento restituisce FALSE, la finestra di acquisizione arresta il processo di acquisizione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Vfw.h

Vedi anche

Acquisizione video

Messaggi di acquisizione video