IAMStats::GetValueByIndex-Methode (control.h)

Artikel
02/28/2024

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die GetValueByIndex -Methode ruft eine Statistik nach Index ab.

Syntax

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

Parameter

[in] lIndex

Nullbasierter Index der Statistik.

[out] szName

Zeiger auf eine Variable, die den Namen der Statistik empfängt.

[out] lCount

Zeiger auf eine Variable, die die Anzahl der aufgezeichneten Werte empfängt.

[out] dLast

Zeiger auf eine Variable, die den zuletzt aufgezeichneten Wert empfängt.

[out] dAverage

Zeiger auf eine Variable, die den Durchschnittswert empfängt.

[out] dStdDev

Zeiger auf eine Variable, die die Standardabweichung der Werte empfängt. Wenn die Anzahl kleiner als zwei ist, ist die Standardabweichung null.

[out] dMin

Zeiger auf eine Variable, die den aufgezeichneten Mindestwert empfängt.

[out] dMax

Zeiger auf eine Variable, die den maximal aufgezeichneten Wert empfängt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_INVALIDARG	Index außerhalb des Bereichs.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.
E_POINTER	NULL-Zeigerargument.

Hinweise

Der Aufrufer muss die in szName zurückgegebene Zeichenfolge durch Aufrufen der SysFreeString-Funktion freigeben.

Rufen Sie IAMStats::GetIndex auf, um die Anzahl der Statistiken abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	control.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IAMStats-Schnittstelle

Freigeben über