Partager via


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

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