Compartir a través de

Método IAMStats::GetValueByIndex (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.

El GetValueByIndex método recupera una estadística, por índice.

Sintaxis

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 de base cero de la estadística.

[out] szName

Puntero a una variable que recibe el nombre de la estadística.

[out] lCount

Puntero a una variable que recibe el número de valores que se registraron.

[out] dLast

Puntero a una variable que recibe el valor más reciente que se registró.

[out] dAverage

Puntero a una variable que recibe el valor medio.

[out] dStdDev

Puntero a una variable que recibe la desviación estándar de los valores. Si el recuento es menor que dos, la desviación estándar es cero.

[out] dMin

Puntero a una variable que recibe el valor mínimo que se registró.

[out] dMax

Puntero a una variable que recibe el valor máximo que se registró.

Valor devuelto

Devuelve un valor HRESULT . Estos son algunos de los valores posibles.

Código devuelto Descripción
S_OK
 Correcto.
E_INVALIDARG
 Índice fuera del intervalo.
E_OUTOFMEMORY
 Memoria insuficiente.
E_POINTER
 Argumento de puntero NULL.

Comentarios

El llamador debe liberar la cadena devuelta en szName mediante una llamada a la función SysFreeString .

Para obtener el número de estadísticas, llame a IAMStats::GetIndex.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado control.h (incluir Dshow.h)
Library Strmiids.lib

Consulte también

Códigos de error y éxito

IAMStats (interfaz)