IAMStats::GetValueByName-Methode (control.h)

[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 GetValueByName -Methode ruft eine Statistik anhand des Namens ab.

Syntax

HRESULT GetValueByName(
  [in]  BSTR   szName,
  [out] long   *lIndex,
  [out] long   *lCount,
  [out] double *dLast,
  [out] double *dAverage,
  [out] double *dStdDev,
  [out] double *dMin,
  [out] double *dMax
);

Parameter

[in] szName

Gibt den Namen der Statistik an.

[out] lIndex

Zeiger auf eine Variable, die den Index dieser 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	Keine Übereinstimmung für diesen Namen.
E_POINTER	NULL-Zeigerargument.

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