Método IAMStats::GetValueByIndex (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.]
O GetValueByIndex
método recupera uma estatística, por índice.
Sintaxe
HRESULT GetValueByIndex(
[in] long lIndex,
[out] BSTR *szName,
[out] long *lCount,
[out] double *dLast,
[out] double *dAverage,
[out] double *dStdDev,
[out] double *dMin,
[out] double *dMax
);
Parâmetros
[in] lIndex
Índice baseado em zero da estatística.
[out] szName
Ponteiro para uma variável que recebe o nome da estatística.
[out] lCount
Ponteiro para uma variável que recebe o número de valores que foram registrados.
[out] dLast
Ponteiro para uma variável que recebe o valor mais recente que foi registrado.
[out] dAverage
Ponteiro para uma variável que recebe o valor médio.
[out] dStdDev
Ponteiro para uma variável que recebe o desvio padrão dos valores. Se a contagem for menor que duas, o desvio padrão será zero.
[out] dMin
Ponteiro para uma variável que recebe o valor mínimo que foi registrado.
[out] dMax
Ponteiro para uma variável que recebe o valor máximo que foi registrado.
Retornar valor
Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.
Código de retorno | Descrição |
---|---|
|
Êxito. |
|
Índice fora do intervalo. |
|
Memória insuficiente. |
|
Argumento de ponteiro NULL. |
Comentários
O chamador deve liberar a cadeia de caracteres retornada em szName chamando a função SysFreeString .
Para obter o número de estatísticas, chame IAMStats::GetIndex.
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) |
Biblioteca | Strmiids.lib |