WM_CAP_SET_CALLBACK_YIELD message

Le message WM_CAP_SET_CALLBACK_YIELD définit une fonction de rappel dans l’application. AVICap appelle cette procédure lorsque la fenêtre de capture s’affiche pendant la capture en streaming. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro capSetCallbackOnYield .

WM_CAP_SET_CALLBACK_YIELD 
wParam = (WPARAM) 0; 
lParam = (LPARAM) (LPVOID) (fpProc); 

Paramètres

fpProc

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

Valeur renvoyée

Retourne TRUE si elle réussit ou FALSE si la capture en continu ou une session de capture à une seule image est en cours.

Notes

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é après la fin de la capture en continu.

Les applications effectuent généralement un certain 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 susceptibles de provoquer 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.

Spécifications

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]
En-tête	Vfw.h

Voir aussi

Capture vidéo

Messages de capture vidéo