Método ICaptureGraphBuilder::ControlStream (strmif.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.]

Nota A interface ICaptureGraphBuilder foi preterida. Em vez disso, use ICaptureGraphBuilder2 .
 
Envia mensagens de controle de fluxo para o pino da categoria especificada em um ou mais filtros de captura em um grafo.

Sintaxe

HRESULT ControlStream(
  [in] const GUID     *pCategory,
  [in] IBaseFilter    *pFilter,
  [in] REFERENCE_TIME *pstart,
  [in] REFERENCE_TIME *pstop,
  [in] WORD           wStartCookie,
  [in] WORD           wStopCookie
);

Parâmetros

[in] pCategory

Ponteiro para um GUID que especifica a categoria de pino de saída. Consulte Fixar Conjunto de Propriedades para obter uma lista de todas as categorias de pino. Esse valor não pode ser NULL.

[in] pFilter

Ponteiro para uma interface IBaseFilter no filtro a ser controlado. Especificar controles NULL todos os filtros de captura no grafo. Você receberá uma notificação para cada filtro de captura.

[in] pstart

Ponteiro para a hora de início da captura. NULL significa iniciar agora. MAX_TIME significa cancelar a solicitação anterior ou não executar nenhuma ação se não houver nenhuma solicitação anterior.

[in] pstop

Ponteiro para o tempo de parada para captura. NULL significa parar agora. MAX_TIME significa cancelar a solicitação anterior ou não executar nenhuma ação se não houver nenhuma solicitação anterior.

[in] wStartCookie

Especifica um valor específico a ser enviado quando o início ocorre.

[in] wStopCookie

Especifica um valor específico a ser enviado quando a parada ocorrer.

Retornar valor

Retorna S_FALSE se a notificação de parada for enviada antes que o último exemplo enviado pelo filtro de captura seja renderizado; caso contrário, retornará S_OK.

Se esse método retornar S_FALSE, talvez o aplicativo queira aguardar antes de interromper o grafo de filtro para permitir que todos os exemplos passem pelo grafo e sejam renderizados. Caso contrário, os exemplos poderão ser perdidos.

Se não houver pinos que correspondam à descrição fornecida ou se o controle de fluxo não puder ter suporte em todos os pinos indicados, essa função retornará um código de falha.

Comentários

Use esse método para captura com precisão de quadro ou para controle individual de captura e visualização. Por exemplo, você pode desativar a gravação da imagem capturada no disco se quiser apenas visualizar a imagem capturada.

Esse método usa a interface IAMStreamControl nos pinos.

Esse método envia uma notificação para cada filtro encontrado com um pino da categoria especificada.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)

Confira também

Códigos de erro e êxito

ICaptureGraphBuilder Interface