Funzione di callback CAPCONTROLCALLBACK (vfw.h)
La funzione capControlCallback è la funzione callback usata per il controllo di precisione per avviare e terminare l'acquisizione di streaming. Il nome capControlCallback è un segnaposto per il nome della funzione fornita dall'applicazione.
Per impostare il callback, inviare il messaggio di WM_CAP_SET_CALLBACK_CAPCONTROL alla finestra di acquisizione o chiamare la macro capSetCallbackOnCapControl .
Sintassi
CAPCONTROLCALLBACK Capcontrolcallback;
LRESULT Capcontrolcallback(
HWND hWnd,
int nState
)
{...}
Parametri
hWnd
Handle alla finestra di acquisizione associata alla funzione di callback.
nState
Stato corrente dell'operazione di acquisizione. Il valore CONTROLCALLBACK_PREROLL viene inviato inizialmente per abilitare la prerolling delle origini video e restituire il controllo all'applicazione di acquisizione al momento esatto della registrazione. Il valore CONTROLCALLBACK_CAPTURING viene inviato una volta per ogni frame acquisito per indicare che l'acquisizione di streaming è in corso e per consentire all'applicazione di terminare l'acquisizione.
Valore restituito
Quando nState è impostato su CONTROLCALLBACK_PREROLL, questa funzione di callback deve restituire TRUE per avviare l'acquisizione o FALSE per interromperla. Quando nState è impostato su CONTROLCALLBACK_CAPTURING, questa funzione di callback deve restituire TRUE per continuare a acquisire o terminare false .
Commenti
Il primo messaggio inviato alla routine di callback imposta il parametro nState su CONTROLCALLBACK_PREROLL dopo aver allocato tutti i buffer e tutte le altre operazioni di preparazione di acquisizione sono completate.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vfw.h |