Interface IAMStats (control.h)

[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 IAMStats interface recupera dados de desempenho do Gerenciador de Gráficos de Filtro. Os filtros podem usar essa interface para registrar dados de desempenho.

Filtrar desenvolvedores: assim como acontece com todas as interfaces do Gerenciador de Grafo de Filtro, um filtro não deve conter uma contagem de referência nessa interface ou causará uma contagem de referência circular. Para obter mais informações, consulte IBaseFilter::JoinFilterGraph.

Herança

A interface IAMStats herda da interface IDispatch . O IAMStats também tem estes tipos de membros:

Métodos

A interface IAMStats tem esses métodos.

IAMStats::AddValue O método AddValue registra um novo valor.
IAMStats::get_Count O método get_Count recupera o número de estatísticas.
IAMStats::GetIndex O método GetIndex recupera o índice de uma estatística nomeada ou cria uma nova estatística.
IAMStats::GetValueByIndex O método GetValueByIndex recupera uma estatística, por índice.
IAMStats::GetValueByName O método GetValueByName recupera uma estatística, por nome.
IAMStats::Reset O método Reset redefine todas as estatísticas para zero.

Comentários

Cada estatística é definida por um nome e um índice. Use o método GetIndex para localizar o índice do nome. Os valores são sempre tipos duplos . As estatísticas a seguir são predefinidas.

Nome	Descrição
Renderfile	Mede o tempo gasto por cada chamada para IGraphBuilder::RenderFile.
ConnectDirectInternal	Mede o tempo necessário para conectar dois filtros.
Cache do Mapeador de Build	Mede o tempo necessário para armazenar em cache informações sobre filtros registrados (usados pelo objeto Mapeador de Filtro ).
Categoria do Processo CategoryName	Mede o tempo necessário para armazenar em cache informações sobre filtros em uma categoria específica, em que CategoryName é o nome amigável da categoria de filtro. (Consulte Categorias de filtro.)

 

Para cada uma dessas estatísticas, os valores representam o tempo em milissegundos.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	control.h (inclua Dshow.h)

Confira também

IDispatch