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

Vedi anche

Acquisizione video

Funzioni di acquisizione video