IAMTVTuner::AutoTune-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die AutoTune Methode sucht nach einem präzisen Signal auf der Kanalfrequenz.

Syntax

HRESULT AutoTune(
  [in]  long lChannel,
  [out] long *plFoundSignal
);

Parameter

[in] lChannel

Tv-Kanalnummer.

[out] plFoundSignal

Zeiger auf eine Variable, die angibt, ob die Häufigkeit des Kanals gefunden wurde; nonzero gibt an, dass gefunden, null nicht gefunden wurde.

Rückgabewert

Gibt einen HRESULT-Wert zurück, der von der Implementierung der Schnittstelle abhängt.

Hinweise

Tv-Kanäle ordnen in der Regel eine eindeutige Häufigkeit zu, abhängig von regionalen Abweichungen. Um Störungen zwischen mehreren Sendern zu vermeiden, denen derselbe Kanal zugewiesen ist, wenn sie sich in unmittelbarer geografischer Nähe befinden, werden an jedem Sender kleine Frequenzoffsets eingeführt. Im USA reicht dieser Offset bis zu +/– 26,25 Kilohertz (kHz).

Diese Methode verarbeitet die Kanal-zu-Frequenz-Konvertierung und scannt nach der präzisesten Frequenz. Speichern Sie diese Werte, indem Sie die IAMTVTuner::StoreAutoTune-Methode aufrufen. Basisfrequenzen für Kanäle finden Sie im Anhang International Analog TV Tuning.

Anforderungen

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

Weitere Informationen

Fehler- und Erfolgscodes

IAMTVTuner-Schnittstelle

IAMTuner-Schnittstelle