Interface IQueueCommand (control.h)

  • Artigo

[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.]

A IQueueCommand interface enfileira um comando para processamento em um momento designado. O Gerenciador de Grafo de Filtro expõe essa interface. Os aplicativos podem usá-lo para enfileirar comandos de controle de grafo com antecedência.

Os métodos em IQueueCommand são modelados após o método IDispatch::InvokeAt . O aplicativo especifica uma interface, um método na interface, parâmetros para o método e um tempo de referência. O Gerenciador de Grafo de Filtro enfileira essas informações e invoca o método no momento especificado. A interface solicitada deve herdar IDispatch e deve ser exposta pelo Gerenciador de Grafo de Filtro. Os exemplos incluem IMediaControl, IMediaEventEx e IMediaPosition.

Quando o comando é enfileirado, o gerenciador de grafo de filtro retorna um ponteiro para a interface IDeferredCommand . O aplicativo pode usar essa interface para cancelar ou modificar o comando.

Nota Os dois métodos em IQueueCommand referem-se ao tempo de transmissão e ao tempo de apresentação, respectivamente. No contexto do Gerenciador do Gráfico de Filtro, o tempo de fluxo e o tempo de apresentação são idênticos, portanto, não há diferença funcional entre os dois métodos. Outros objetos podem implementar IQueueCommand de forma diferente. Para obter mais informações sobre o tempo de transmissão e o tempo de apresentação, consulte Hora e Relógios no DirectShow.
 

Herança

A interface IQueueCommand herda da interface IUnknown . IQueueCommand também tem estes tipos de membros:

Métodos

A interface IQueueCommand tem esses métodos.

 
IQueueCommand::InvokeAtPresentationTime

O método InvokeAtPresentationTime enfileira um método a ser invocado no momento da apresentação especificado.
IQueueCommand::InvokeAtStreamTime

O método InvokeAtStreamTime enfileira um método ou alteração de propriedade para execução em um tempo de fluxo especificado (ou seja, o tempo de apresentação em relação ao deslocamento de tempo de fluxo atual).

Requisitos

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