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 |