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

Démarre la préversion.

Syntaxe

HRESULT StartPreview();

Valeur de retour

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
MF_E_INVALIDREQUEST	Le récepteur d’aperçu n’a pas été initialisé.

Remarques

Avant d’appeler cette méthode, configurez le récepteur en préversion en appelant IMFCaptureSink ::AddStream. Pour obtenir un pointeur vers le récepteur en préversion, 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_PREVIEW_STARTED par le biais de la méthode IMFCaptureEngineOnEventCallback ::OnEvent . L’opération peut échouer de manière asynchrone une fois la méthode réussie. Si c’est le cas, le code d’erreur est transmis via la méthode OnEvent .

Une fois le récepteur d’aperçu configuré, vous pouvez arrêter et démarrer la préversion en appelant IMFCaptureEngine ::StopPreview et IMFCaptureEngine ::StartPreview.

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