signal-Befehl

Der Signalbefehl identifiziert eine angegebene Position im Arbeitsbereich, indem er der Anwendung eine MM _ MCISIGNAL-Nachricht sendet. Digitalvideogeräte erkennen diesen Befehl. MCIAVI unterstützt nur ein aktives Signal gleichzeitig.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion mit dem lpszCommand-Parameter auf, der 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, in dem ein Signal aufgerufen werden soll.
cancel Entfernt Signale aus dem Arbeitsbereich. Ein einzelnes Signal wird mithilfe des Flags "uservalue" angegeben. Wenn das Flag "uservalue" nicht mit "cancel" angegeben wird, bricht das Gerät alle Signale ab. Das Flag "cancel" ist nicht kompatibel mit den Flags "at", "every" und "return position".
jedes Intervall Gibt den Zeitraum der Signale an. Der Intervallwert wird im aktuellen Zeitformat angegeben. Bei Verwendung mit der Position "at" werden Signale im gesamten Arbeitsbereich mit einer Signalmarkung an Position platziert.
Ohne das Flag "at" werden Signale im gesamten Arbeitsbereich mit einem Signal an der aktuellen Position platziert.
Wenn dieses Flag weggelassen wird, wird nur die durch das Flag "at" angegebene Position markiert.
Wenn der Intervallwert kleiner als die von einem Gerät unterstützte Mindesthäufigkeit ist, wird der Mindestwert verwendet.
Rückgabeposition Gibt an, dass das Gerät den Positionswert anstelle des Bezeichners "uservalue" in der Signalisierungsmeldung senden soll. Der Bezeichner "uservalue" kann weiterhin verwendet werden, um die Signalmarkierungen abzubricht oder neu zu definieren.
uservalue id Gibt einen Bezeichner an, der mit der Signalisierungsmeldung zurück gemeldet wird. Dieser Bezeichner fungiert als Bezeichner, der mit anderen Signalbefehlen verwendet werden kann, um auf diese Signaleinstellung zu verweisen. Wenn dieser Wert nicht angegeben wird, ist der Standardwert 0 (null).

lpszFlags

Kann "wait", "notify", "test" oder eine Kombination aus diesen sein. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt 0 (null) zurück, wenn erfolgreich, andernfalls ein Fehler.

Bemerkungen

Das Fensterhand handle, das für die Benachrichtigung über 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]

Siehe auch

MCI

MCI-Befehlszeichenfolgen

MM _ MCISIGNAL