Interfaz IQueueCommand (control.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.

La IQueueCommand interfaz pone en cola un comando para su procesamiento en un momento designado. Filter Graph Manager expone esta interfaz. Las aplicaciones pueden usarlas para poner en cola comandos de control de grafos de antemano.

Los métodos de IQueueCommand se modelan después del método IDispatch::InvokeAt . La aplicación especifica una interfaz, un método en la interfaz, parámetros para el método y una hora de referencia. El Administrador de gráficos de filtros pone en cola esta información y, a continuación, invoca el método en el momento especificado. La interfaz solicitada debe heredar IDispatch y debe exponerla el Administrador de gráficos de filtros. Algunos ejemplos son IMediaControl, IMediaEventEx e IMediaPosition.

Cuando el comando se pone en cola, el administrador de gráficos de filtros devuelve un puntero a la interfaz IDeferredCommand . La aplicación puede usar esta interfaz para cancelar o modificar el comando.

Nota Los dos métodos de IQueueCommand hacen referencia al tiempo de transmisión y al tiempo de presentación, respectivamente. En el contexto del Administrador de gráficos de filtros, el tiempo de transmisión y el tiempo de presentación son idénticos, por lo que no hay ninguna diferencia funcional entre los dos métodos. Otros objetos podrían implementar de IQueueCommand forma diferente. Para obtener más información sobre el tiempo de transmisión y la hora de presentación, vea Time and Clocks in DirectShow.
 

Herencia

La interfaz IQueueCommand hereda de la interfaz IUnknown . IQueueCommand también tiene estos tipos de miembros:

Métodos

La interfaz IQueueCommand tiene estos métodos.

 
IQueueCommand::InvokeAtPresentationTime

El método InvokeAtPresentationTime pone en cola un método que se va a invocar en el tiempo de presentación especificado.
IQueueCommand::InvokeAtStreamTime

El método InvokeAtStreamTime pone en cola un cambio de propiedad o método para su ejecución en un tiempo de flujo especificado (es decir, el tiempo de presentación con respecto al desplazamiento de tiempo de flujo actual).

Requisitos

   
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 control.h (incluir Dshow.h)