Partager via


Méthode IMFCaptureSource ::AddEffect (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 suivantes.

Valeur Signification
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 de 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 Description
S_OK
Réussite.
MF_E_INVALIDMEDIATYPE
Aucun type de support 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 un instance du 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.

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

IMFCaptureSource