Método IMPEG2StreamIdMap::MapStreamId (strmif.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
O MapStreamId método mapeia a ID de Stream de um fluxo elementar dentro de um fluxo de programa MPEG-2 para um tipo de conteúdo de mídia e informações de filtragem de subfluxo.
Sintaxe
HRESULT MapStreamId(
[in] ULONG ulStreamId,
[in] DWORD MediaSampleContent,
[in] ULONG ulSubstreamFilterValue,
[in] int iDataOffset
);
Parâmetros
[in] ulStreamId
A ID de fluxo do fluxo PES.
[in] MediaSampleContent
Especifica o conteúdo do fluxo. Atualmente, o único valor com suporte é MPEG2_PROGRAM_ELEMENTARY_STREAM (definido como 0x00000001 em axextend.idl).
[in] ulSubstreamFilterValue
Especifica qual subfluxo dentro desse fluxo elementar será passado para o decodificador downstream. Somente o byte de baixa ordem pode conter um valor de filtro válido. Se iDataOffset = 0, esse parâmetro será ignorado.
[in] iDataOffset
O deslocamento de bytes para o conteúdo no qual o subfluxo começa.
Retornar valor
Retorna S_OK se tiver êxito. Se o método falhar, um código de erro será retornado. Se uma ID de Stream de MEDIA_PROGRAM_STREAM_MAP, MEDIA_PROGRAM_DIRECTORY_PES_PACKET ou MEDIA_PROGRAM_PACK_HEADER for tentada, esse método retornará E_NOTIMPL.
Comentários
A ID de Stream mapeada por esse método é a ID de fluxo no cabeçalho PES. A filtragem de subfluxo é mais comumente usada para fornecer vários canais em um único fluxo de áudio.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |