Méthode IMFCaptureSink ::P repare (mfcaptureengine.h)

Prépare le récepteur de capture en chargeant tous les composants de pipeline requis, tels que les encodeurs, les processeurs vidéo et les récepteurs multimédias.

Syntaxe

HRESULT Prepare();

Valeur de retour

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

Code de retour	Description
S_OK	Réussite.
MF_E_INVALIDREQUEST	Demande non valide.

Remarques

L’appel de cette méthode est facultatif. Cette méthode permet à l’application de configurer les composants du pipeline avant qu’ils ne soient utilisés. Cette méthode est asynchrone. Si la méthode retourne un code de réussite, l’appelant reçoit un événement MF_CAPTURE_SINK_PREPARED via la méthode IMFCaptureEngineOnEventCallback ::OnEvent . Une fois cet événement reçu, appelez IMFCaptureSink ::GetService pour configurer des composants individuels.

Avant d’appeler cette méthode, configurez le récepteur de capture en ajoutant au moins un flux. Pour ajouter un flux, appelez IMFCaptureSink ::AddStream.

La méthode Prepare échoue si le récepteur de capture est actuellement utilisé. Par exemple, l’appel de Prepare sur le récepteur de préversion échoue si le moteur de capture est en cours d’aperçu.

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

IMFCaptureSink