Compartir a través de


Método IAMStats::GetIndex (control.h)

[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 GetIndex método recupera el índice de una estadística con nombre o crea una nueva estadística.

Sintaxis

HRESULT GetIndex(
  [in]  BSTR szName,
  [in]  long lCreate,
  [out] long *plIndex
);

Parámetros

[in] szName

Especifica el nombre de la estadística.

[in] lCreate

Especifica si se va a crear la estadística, si aún no está definida. Si el valor es TRUE, el método crea un nuevo índice para la estadística cuando no encuentra una entrada existente con ese nombre. Si el valor es FALSE, se produce un error en el método cuando la estadística aún no existe.

[out] plIndex

Recibe el índice.

Valor devuelto

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

Código devuelto Descripción
S_OK
Correcto.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
No hay coincidencia con este nombre.
E_POINTER
Argumento de puntero NULL.

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 (include Dshow.h)
Library Strmiids.lib

Consulte también

Códigos de error y éxito

IAMStats (interfaz)