macro capSetCallbackOnYield (vfw.h)

La macro capSetCallbackOnYield définit une fonction de rappel dans l’application. AVICap appelle cette procédure lorsque la fenêtre de capture se produit pendant la capture en streaming. Vous pouvez utiliser cette macro ou appeler explicitement le message WM_CAP_SET_CALLBACK_YIELD .

Syntaxe

void capSetCallbackOnYield(
   hwnd,
   fpProc
);

Paramètres

hwnd

Gérer vers une fenêtre de capture.

fpProc

Pointeur vers la fonction de rappel de rendement, de type capYieldCallback. Spécifiez NULL pour ce paramètre afin de désactiver une fonction de rappel de rendement précédemment installée.

Valeur de retour

None

Remarques

Les applications peuvent éventuellement définir une fonction de rappel de rendement. La fonction de rappel de rendement est appelée au moins une fois pour chaque image vidéo capturée lors de la capture en streaming. Si une fonction de rappel de rendement est installée, elle est appelée quel que soit l’état du membre fYield de la structure CAPTUREPARMS .

Si la fonction de rappel de rendement est utilisée, elle doit être installée avant de démarrer la session de capture et elle doit rester activée pendant toute la durée de la session. Il peut être désactivé une fois la capture de streaming terminée.

Les applications effectuent généralement un type de traitement des messages dans la fonction de rappel composée d’une boucle PeekMessage, TranslateMessage, DispatchMessage , comme dans la boucle de message d’une fonction WinMain . La fonction de rappel de rendement doit également filtrer et supprimer les messages qui peuvent causer des problèmes de réentrance.

Une application retourne généralement TRUE dans la procédure de rendement pour continuer la capture en streaming. Si une fonction de rappel de rendement retourne FALSE, la fenêtre de capture arrête le processus de capture.

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

Macros de capture vidéo