Méthode IMPEG2StreamIdMap ::MapStreamId (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 MapStreamId méthode mappe l’ID Stream d’un flux élémentaire au sein d’un flux de programme MPEG-2 à un type de contenu multimédia et à des informations de filtrage de sous-flux.
Syntaxe
HRESULT MapStreamId(
[in] ULONG ulStreamId,
[in] DWORD MediaSampleContent,
[in] ULONG ulSubstreamFilterValue,
[in] int iDataOffset
);
Paramètres
[in] ulStreamId
ID de flux du flux PES.
[in] MediaSampleContent
Spécifie le contenu du flux. Actuellement, la seule valeur prise en charge est MPEG2_PROGRAM_ELEMENTARY_STREAM (définie comme 0x00000001 dans axextend.idl).
[in] ulSubstreamFilterValue
Spécifie le sous-flux de ce flux élémentaire à transmettre au décodeur en aval. Seul l’octet de faible ordre peut contenir une valeur de filtre valide. Si iDataOffset = 0, ce paramètre est ignoré.
[in] iDataOffset
Décalage d’octet dans la charge utile à laquelle commence le sous-flux.
Valeur retournée
Retourne S_OK en cas de réussite. Si la méthode échoue, un code d’erreur est retourné. Si un ID de Stream de MEDIA_PROGRAM_STREAM_MAP, MEDIA_PROGRAM_DIRECTORY_PES_PACKET ou MEDIA_PROGRAM_PACK_HEADER est tenté, cette méthode retourne E_NOTIMPL.
Remarques
L’ID Stream mappé par cette méthode est l’ID de flux dans l’en-tête PES. Le filtrage de sous-flux est le plus couramment utilisé pour fournir plusieurs canaux sur un seul flux audio.
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 |