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

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El NewSegment método notifica al pin que las muestras multimedia recibidas después de esta llamada se agrupan como un segmento, con una hora de inicio común, una hora de detención y una velocidad.

Las aplicaciones no deben llamar a este método. Otros filtros llaman a este método.

Sintaxis

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

Parámetros

tStart

Hora de inicio del segmento, con respecto al origen original, en unidades de 100 nanosegundos.

tStop

Hora de finalización del segmento, relativa al origen original, en unidades de 100 nanosegundos.

dRate

Velocidad a la que se debe procesar este segmento, como porcentaje de la tasa original.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente o un valor HRESULT que indica la causa del error.

Comentarios

Un filtro de origen (o filtro del analizador) llama a este método al principio de cada nueva secuencia y después de cada operación de búsqueda. Llama al método en el pin de entrada del filtro de bajada, después de entregar el lote anterior de datos y antes de llamar a IMemInputPin::Receive con cualquier dato nuevo. El filtro de bajada propaga la NewSegment llamada de bajada.

Los filtros pueden usar información de segmento para procesar ejemplos. Por ejemplo, con algunos formatos es imposible reconstruir un marco delta sin el siguiente fotograma clave. Por lo tanto, si la hora de detención se produce en un marco delta, el filtro de origen debe enviar algunos fotogramas adicionales. El filtro de descodificador determina el marco final en función de la información del segmento. La velocidad de segmento se usa para representar orígenes de datos continuos, como datos de audio. Por ejemplo, el representador de audio usa la frecuencia de muestreo y la velocidad de segmento para representar los datos de audio correctamente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado strmif.h (incluya Dshow.h)
Library Strmiids.lib

Consulte también

Data Flow en el gráfico de filtros

Códigos de error y éxito

IPin (interfaz)