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 |