Méthode IMFCaptureSource ::AddEffect (mfcaptureengine.h)

Article
03/01/2024

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

Partager via