Partager via


IMFCaptureSource ::AddEffect, méthode (mfcaptureengine.h)

Ajoute un effet à un flux de capture.

Syntaxe

HRESULT AddEffect(
  [in] DWORD    dwSourceStreamIndex,
  [in] IUnknown *pUnknown
);

Paramètres

[in] dwSourceStreamIndex

Flux de capture. La valeur peut être l’une des valeurs suivantes.

Valeur Meaning
0 à 0xFFFFFFFB
Index de base zéro d’un flux. Pour obtenir le nombre de flux, appelez IMFCaptureSource ::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
Premier flux d’images.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
Premier flux vidéo.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
Premier flux audio.

[in] pUnknown

Pointeur vers l’un des éléments suivants :

  • Transformation Media Foundation (MFT) qui expose l’interface IMFTransform .
  • Objet d’activation MFT qui expose l’interface IMFActivate .

Valeur retournée

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

Code de retour Descriptif
S_OK
Opération réussie.
MF_E_INVALIDMEDIATYPE
Aucun type de média compatible n’est trouvé.
MF_E_INVALIDSTREAMNUMBER
Le paramètre dwSourceStreamIndex n’est pas valide.

Remarques

L’effet doit être implémenté en tant que transformation Media Foundation (MFT). Le paramètre pUnknown peut pointer vers une instance de MFT ou vers un objet d’activation pour le MFT. Pour plus d’informations, consultez Objets d’activation.

L’effet est appliqué au flux avant que les données atteignent les récepteurs de capture.

Spécifications

Requirement Valeur
Client minimum requis Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
plateforme cible Fenêtres
Header mfcaptureengine.h

Voir aussi

IMFCaptureSource