capSetCallbackOnYield, macro (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 génère pendant la capture de streaming. Vous pouvez utiliser cette macro ou appeler explicitement le message WM_CAP_SET_CALLBACK_YIELD .

Syntaxe

BOOL 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 pour désactiver une fonction de rappel de rendement précédemment installée.

Valeur retournée

Type : BOOL

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

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 de streaming. Si une fonction de rappel de rendement est installée, elle est appelée indépendamment de 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 la durée de la session. Elle peut être désactivée après la fin de la capture de diffusion en continu.

Les applications effectuent généralement un type de traitement de message 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 des messages qui peuvent entraîner des problèmes de réentrance.

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

Spécifications

Voir aussi

de capture vidéo

Macros de capture vidéo