Metodo IMPEG2StreamIdMap::MapStreamId (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il MapStreamId metodo esegue il mapping dell'ID Stream di un flusso elementare all'interno di un flusso di programma MPEG-2 a un tipo di contenuto multimediale e informazioni di filtro substream.

Sintassi

HRESULT MapStreamId(
  [in] ULONG ulStreamId,
  [in] DWORD MediaSampleContent,
  [in] ULONG ulSubstreamFilterValue,
  [in] int   iDataOffset
);

Parametri

[in] ulStreamId

ID flusso del flusso PES.

[in] MediaSampleContent

Specifica il contenuto del flusso. Attualmente l'unico valore supportato è MPEG2_PROGRAM_ELEMENTARY_STREAM (definito come 0x00000001 in axextend.idl).

[in] ulSubstreamFilterValue

Specifica il sottostream all'interno di questo flusso elementare da passare al decodificatore downstream. Solo il byte con ordine basso può contenere un valore di filtro valido. Se iDataOffset = 0, questo parametro viene ignorato.

[in] iDataOffset

Offset di byte nel payload in corrispondenza del quale inizia il sottostream.

Valore restituito

Restituisce S_OK in caso di esito positivo. Se il metodo ha esito negativo, viene restituito un codice di errore. Se viene eseguito un Stream ID di MEDIA_PROGRAM_STREAM_MAP, MEDIA_PROGRAM_DIRECTORY_PES_PACKET o MEDIA_PROGRAM_PACK_HEADER viene eseguito un tentativo, questo metodo restituisce E_NOTIMPL.

Commenti

L'ID Stream mappato da questo metodo è l'ID flusso nell'intestazione PES. Il filtro substream viene usato più comunemente per fornire più canali in un singolo flusso audio.

Requisiti

Vedi anche

Codici di errore e di esito positivo

Interfaccia IMPEG2StreamIdMap