IAMStats::GetIndex-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 GetIndex -Methode ruft den Index für eine benannte Statistik ab oder erstellt eine neue Statistik.
Syntax
HRESULT GetIndex(
[in] BSTR szName,
[in] long lCreate,
[out] long *plIndex
);
Parameter
[in] szName
Gibt den Namen der Statistik an.
[in] lCreate
Gibt an, ob die Statistik erstellt werden soll, wenn sie noch nicht definiert ist. Wenn der Wert TRUE ist, erstellt die Methode einen neuen Index für die Statistik, wenn sie keinen vorhandenen Eintrag mit diesem Namen finden kann. Wenn der Wert FALSE ist, schlägt die Methode fehl, wenn die Statistik noch nicht vorhanden ist.
[out] plIndex
Empfängt den Index.
Rückgabewert
Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Keine Übereinstimmung für diesen Namen. |
|
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 |