Partager via


Méthode IMFCaptureEngine ::TakePhoto (mfcaptureengine.h)

Capture une image fixe à partir du flux vidéo.

Syntaxe

HRESULT TakePhoto();

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Avant d’appeler cette méthode, configurez le récepteur de photos en appelant IMFCaptureSink ::AddStream. Pour obtenir un pointeur vers le récepteur de photos, appelez IMFCaptureEngine ::GetSink.

Cette méthode est asynchrone. Si la méthode retourne un code de réussite, l’appelant reçoit un événement MF_CAPTURE_ENGINE_PHOTO_TAKEN via la méthode IMFCaptureEngineOnEventCallback ::OnEvent . L’opération peut échouer de façon asynchrone une fois la méthode réussie. Dans ce cas, le code d’erreur est transmis par le biais de la méthode OnEvent .

Configuration requise

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

Voir aussi

IMFCaptureEngine