settuner-Befehl

Artikel
06/13/2023

Der Settuner-Befehl ändert den aktuellen Tuner oder die Kanaleinstellung des aktuellen Tuners. VcR-Geräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand wie folgt festgelegt ist.

_stprintf_s(
  lpszCommand, 
  TEXT("settuner %s %s %s"), 
  lpszDeviceID, 
  lpszTuner, 
  lpszFlags
);

Parameter

lpszDeviceID

Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.

lpszTuner

Eines der folgenden Flags.

Wert	Bedeutung
Kanalkanal	Legt den Tuner auf Kanal fest. Je nach VcR können Sie den Kanal möglicherweise nicht während der Aufzeichnung ändern. Ein Kanal, der größer als das Maximum ist, legt den Tuner auf den maximalen Kanal fest.
Channel seek upchannel seek down	Sucht den nächsten Kanal mit einem gültigen Signal. "Suchen" erhöht die Kanalnummer in der Suche. "Suchen nach unten" dekrementiert die Kanalnummer in seiner Suche. Der Tuner umschließt Kanal 1, wenn die maximale Kanalanzahl überschritten wird. Auf ähnliche Weise wird der Tuner beim Suchen nach unten in den maximalen Kanal umschließen.
Kanalupchannel nach unten	Erhöht oder dekrementiert den Tunerkanal. Je nach VcR können Sie den Kanal möglicherweise nicht während der Aufzeichnung ändern. Der Tuner umschließt Kanal 1, wenn die maximale Kanalanzahl überschritten wird. Auf ähnliche Weise wird der Tuner beim Suchen nach unten in den maximalen Kanal umschließen.
Nummer	Gibt den Tuner an, der vom Befehl settuner beeinflusst werden soll. Wenn die Zahl nicht angegeben wird, wird der Standardwert 1 angenommen.

lpszFlags

Kann "warten", "benachrichtigen", "testen" oder eine Kombination aus diesen sein. Weitere Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]

Siehe auch

MCI
MCI-Befehlszeichenfolgen