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