Méthode IMFCaptureSink ::AddStream (mfcaptureengine.h)

Article
03/01/2024

Connecte un flux de la source de capture à ce récepteur de capture.

Syntaxe

HRESULT AddStream(
  [in]  DWORD         dwSourceStreamIndex,
  [in]  IMFMediaType  *pMediaType,
  [in]  IMFAttributes *pAttributes,
  [out] DWORD         *pdwSinkStreamIndex
);

Paramètres

[in] dwSourceStreamIndex

Flux source à connecter. 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] pMediaType

Pointeur IMFMediaType qui spécifie le format souhaité du flux de sortie. Les détails du format dépendent du récepteur de capture.

Récepteur photo : format d’image fixe compatible avec le composant d’acquisition d’images Windows (WIC).
Récepteur en préversion : format audio ou vidéo non compressé.
Récepteur d’enregistrements : format audio ou vidéo qui sera écrit dans le fichier de sortie.

[in] pAttributes

Pointeur vers l’interface IMFAttributes . Pour les flux compressés, vous pouvez utiliser ce paramètre pour configurer l’encodeur. Ce paramètre peut également avoir la valeur NULL.

Pour le récepteur d’aperçu, définissez ce paramètre sur NULL.

[out] pdwSinkStreamIndex

Reçoit l’index du nouveau flux sur le récepteur de capture. Notez que cet index ne correspond pas nécessairement à la valeur de dwSourceStreamIndex.

Valeur retournée

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

Code de retour	Description
S_OK	Réussite.
MF_E_INVALIDMEDIATYPE	Le format spécifié dans pMediaType n’est pas valide pour ce récepteur de capture.
MF_E_INVALIDSTREAMNUMBER	Le paramètre dwSourceStreamIndex n’est pas valide ou le flux source spécifié était déjà connecté à ce récepteur.

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

Partager via