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 |
|---|---|
|
Réussite. |
|
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 |