Signalbefehl

Artikel
06/13/2023

Der Signalbefehl identifiziert eine angegebene Position im Arbeitsbereich, indem der Anwendung eine MM_MCISIGNAL Nachricht gesendet wird. Digital-Videogeräte erkennen diesen Befehl. MCIAVI unterstützt jeweils nur ein aktives Signal.

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

_stprintf_s(
  lpszCommand, 
  TEXT("signal %s %s %s"), 
  lpszDeviceID, 
  lpszSignalFlags, 
  lpszFlags
);

Parameter

lpszDeviceID

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

lpszSignalFlags

Eines der folgenden Flags.

Wert	Bedeutung
an position	Gibt den Frame an, der ein Signal aufrufen soll.
cancel	Entfernt Signale aus dem Arbeitsbereich. Ein einzelnes Signal wird mithilfe des Flags "uservalue" angegeben. Wenn das Flag "uservalue" nicht mithilfe von "cancel" angegeben wird, bricht das Gerät alle Signale ab. Das Flag "cancel" ist mit den Flags "at", "every" und "return position" nicht kompatibel.
jedes Intervall	Gibt den Zeitraum der Signale an. Der Intervallwert wird im aktuellen Zeitformat angegeben. Bei Verwendung der Position "at" werden Signale im gesamten Arbeitsbereich platziert, wobei ein Signalzeichen an der Position platziert wird. Ohne das "at"-Flag werden Signale im gesamten Arbeitsbereich mit einem Signal an der aktuellen Position platziert. Wenn dieses Flag weggelassen wird, wird nur die position markiert, die durch das "at"-Flag angegeben ist. Wenn der Intervallwert kleiner als die von einem Gerät unterstützte Mindesthäufigkeit ist, wird dessen Mindestwert verwendet.
Rückgabeposition	Gibt an, dass das Gerät den Positionswert anstelle des Bezeichners "uservalue" in der Signalnachricht senden soll. Der Bezeichner "uservalue" kann weiterhin verwendet werden, um die Signalmarken abzubrechen oder neu zu definieren.
UserValue-ID	Gibt einen Bezeichner an, der mit der Signalmeldung zurückgegeben wird. Dieser Bezeichner fungiert als Bezeichner, der mit anderen Signalbefehlen verwendet werden kann, um auf diese Signaleinstellung zu verweisen. Wenn nicht angegeben, ist der Standardwert 0.

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.

Bemerkungen

Das Fensterhandle, das für die Benachrichtigung von Befehlsabschlussmeldungen verwendet wird, wird auch für die Signalisierung verwendet.

Anforderungen

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

Weitere Informationen

MCI
MCI-Befehlszeichenfolgen
MM_MCISIGNAL