Metodo IAMStats::GetValueByIndex (control.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetValueByIndex metodo recupera una statistica, in base all'indice.

Sintassi

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
);

Parametri

[in] lIndex

Indice in base zero della statistica.

[out] szName

Puntatore a una variabile che riceve il nome della statistica.

[out] lCount

Puntatore a una variabile che riceve il numero di valori registrati.

[out] dLast

Puntatore a una variabile che riceve il valore più recente registrato.

[out] dAverage

Puntatore a una variabile che riceve il valore medio.

[out] dStdDev

Puntatore a una variabile che riceve la deviazione standard dei valori. Se il conteggio è minore di due, la deviazione standard è zero.

[out] dMin

Puntatore a una variabile che riceve il valore minimo registrato.

[out] dMax

Puntatore a una variabile che riceve il valore massimo registrato.

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice restituito Descrizione
S_OK
Operazione completata.
E_INVALIDARG
Indice non compreso nell'intervallo.
E_OUTOFMEMORY
Memoria insufficiente.
E_POINTER
Argomento puntatore NULL.

Commenti

Il chiamante deve liberare la stringa restituita in szName chiamando la funzione SysFreeString .

Per ottenere il numero di statistiche, chiamare IAMStats::GetIndex.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione control.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Interfaccia IAMStats