Fonction de rappel CAPCONTROLCALLBACK (vfw.h)

  • Article

La fonction capControlCallback est la fonction de rappel utilisée pour le contrôle de précision pour commencer et mettre fin à la capture en streaming. Le nom capControlCallback est un espace réservé pour le nom de la fonction fournie par l’application.

Pour définir le rappel, envoyez le message WM_CAP_SET_CALLBACK_CAPCONTROL à la fenêtre de capture ou appelez la macro capSetCallbackOnCapControl .

Syntaxe

CAPCONTROLCALLBACK Capcontrolcallback;

LRESULT Capcontrolcallback(
  HWND hWnd,
  int nState
)
{...}

Paramètres

hWnd

Gérez la fenêtre de capture associée à la fonction de rappel.

nState

État actuel de l’opération de capture. La valeur CONTROLCALLBACK_PREROLL est initialement envoyée pour activer le prérolling des sources vidéo et pour renvoyer le contrôle à l’application de capture au moment exact où l’enregistrement doit commencer. La valeur CONTROLCALLBACK_CAPTURING est envoyée une fois par image capturée pour indiquer que la capture en streaming est en cours et pour permettre à l’application de mettre fin à la capture.

Valeur retournée

Lorsque nState est défini sur CONTROLCALLBACK_PREROLL, cette fonction de rappel doit retourner TRUE pour démarrer la capture ou FALSE pour l’abandonner. Lorsque nState a la valeur CONTROLCALLBACK_CAPTURING, cette fonction de rappel doit retourner TRUE pour continuer la capture ou FALSE pour y mettre fin.

Remarques

Le premier message envoyé à la procédure de rappel définit le paramètre nState sur CONTROLCALLBACK_PREROLL une fois l’allocation de toutes les mémoires tampons et toutes les autres préparations de capture terminées.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête vfw.h

Voir aussi

Capture vidéo

Fonctions de capture vidéo