Partager via

IMFCaptureSink ::AddStream, méthode (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 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] 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 toujours compatible avec le composant d’acquisition d’images Windows (WIC).
  • Récepteur d’aperçu : 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 être 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 Descriptif
S_OK
 Opération réussie.
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é a déjà été connecté à ce récepteur.

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

IMFCaptureSink

  • Last updated on