IMpeg2Demultiplexer ::SetOutputPinMediaType, méthode (strmif.h)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La SetOutputPinMediaType méthode met à jour le type de média de la broche de sortie spécifiée. (DirectX 9.0 et versions ultérieures.)

Syntaxe

HRESULT SetOutputPinMediaType(
  [in] LPWSTR        pszPinName,
  [in] AM_MEDIA_TYPE *pMediaType
);

Paramètres

[in] pszPinName

Nom convivial de la broche tel que spécifié lors de la création de la broche dans un appel à CreateOutputPin.

[in] pMediaType

Pointeur vers une structure AM_MEDIA_TYPE qui spécifie les informations de nouveau type de média pour la broche.

Valeur retournée

Retourne S_OK en cas de réussite. Si la méthode échoue, elle retourne un code d’erreur HRESULT .

Remarques

Les broches peuvent être reconfigurées à tout moment avec un nouveau type de média. S’il n’existe aucune connexion, le type de média est simplement mis à jour. Si la broche est connectée, la réussite ou l’échec de l’appel dépend de l’acceptation ou du rejet de la broche d’entrée en aval du type de support spécifié.

Le type de média n’est en aucun cas interprété par le filtre Demultiplexer. Il est utilisé uniquement lors de la négociation de la connexion par la broche de sortie. Elle n’a aucun effet sur le contenu des exemples multimédias. L’exemple de contenu multimédia est défini lorsqu’un PID est mappé via le paramètre MEDIA_SAMPLE_CONTENT dans la méthode IMPEG2PIDMap ::MapPID , ou via les valeurs définies dans un appel IMPEG2StreamIdMap ::MapStreamId .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IMpeg2Demultiplexer, interface