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 |
|