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 |