Método COutputQueue.NewSegment

[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 entrega un nuevo segmento al pin de entrada.

Sintaxis

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

Parámetros

tStart

Posición media inicial del segmento, en unidades de 100 nanosegundos.

tStop

Posición del medio final del segmento, en unidades de 100 nanosegundos.

dRate

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

Valor devuelto

Devuelve un valor HRESULT .

Observaciones

Si el objeto usa un subproceso, pone en cola los siguientes elementos en orden:

• Mensaje de control NEW_SEGMENT.
• Datos del segmento.

El mensaje NEW_SEGMENT notifica al subproceso que el siguiente elemento de la cola contendrá datos de segmento. Los datos del segmento se agrupan en una estructura, declarados de la siguiente manera:

struct NewSegmentPacket {
    REFERENCE_TIME tStart;
    REFERENCE_TIME tStop;
    double dRate;
}; 

El subproceso llama al método IPin::NewSegment en el pin de entrada, utilizando los datos proporcionados en la estructura.

Si el objeto no usa un subproceso, llama al método COutputQueue::SendAnyway para entregar los ejemplos pendientes. A continuación, llama a IPin::NewSegment en el pin de entrada.

Requisitos

Requisito	Value
Encabezado	Outputq.h (include Streams.h)
Biblioteca	Strmbase.lib (compilaciones comerciales); Strmbasd.lib (compilaciones de depuración)

Consulte también

COutputQueue (clase)