Método IPin::NewSegment (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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 NewSegment método notifica o pino de que os exemplos de mídia recebidos após essa chamada são agrupados como um segmento, com uma hora de início, hora de parada e taxa comuns.

Os aplicativos não devem chamar esse método. Esse método é chamado por outros filtros.

Sintaxe

HRESULT NewSegment(
  REFERENCE_TIME tStart,
  REFERENCE_TIME tStop,
  double         dRate
);

Parâmetros

tStart

Hora de início do segmento, em relação à origem original, em unidades de 100 nanossegundos.

tStop

Hora de término do segmento, em relação à origem original, em unidades de 100 nanossegundos.

dRate

Taxa na qual esse segmento deve ser processado, como um percentual da taxa original.

Retornar valor

Retorna S_OK se tiver êxito ou um valor HRESULT que indica a causa do erro.

Comentários

Um filtro de origem (ou filtro de analisador) chama esse método no início de cada novo fluxo e após cada operação de busca. Ele chama o método no pin de entrada do filtro downstream, depois de entregar o lote anterior de dados e antes de chamar IMemInputPin::Receive com quaisquer novos dados. O filtro downstream propaga a NewSegment chamada downstream.

Os filtros podem usar informações de segmento para processar exemplos. Por exemplo, com alguns formatos, é impossível reconstruir um quadro delta sem o próximo quadro-chave. Portanto, se o tempo de parada ocorrer em um quadro delta, o filtro de origem deverá enviar alguns quadros adicionais. O filtro de decodificador determina o quadro final com base nas informações do segmento. A taxa de segmento é usada para renderizar fontes de dados contínuas, como dados de áudio. Por exemplo, o renderizador de áudio usa a taxa de amostragem e a taxa de segmento para renderizar os dados de áudio corretamente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	strmif.h (inclua Dshow.h)
Biblioteca	Strmiids.lib

Confira também

Fluxo de Dados no Grafo de Filtro

Códigos de erro e êxito

IPin Interface