macro capSetCallbackOnYield (vfw.h)

La macro capSetCallbackOnYield imposta una funzione di callback nell'applicazione. AVICap chiama questa procedura quando la finestra di acquisizione restituisce durante l'acquisizione di streaming. È possibile utilizzare questa macro o chiamare in modo esplicito il messaggio di WM_CAP_SET_CALLBACK_YIELD .

Sintassi

void capSetCallbackOnYield(
   hwnd,
   fpProc
);

Parametri

hwnd

Handle in una finestra di acquisizione.

fpProc

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

Valore restituito

nessuno

Osservazioni

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

Se viene usata la funzione di callback yield, deve essere installata prima di avviare la sessione di acquisizione e deve rimanere abilitata per la durata della sessione. Può essere disabilitata al termine 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 yield deve anche filtrare e rimuovere messaggi che possono causare problemi di reentrancy.

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

Requisiti

Vedi anche

Acquisizione video

Macro di acquisizione video