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] |