Befehl "update"
Der Updatebefehl bemalt den aktuellen Frame erneut in den angegebenen Gerätekontext (DC). Digitalvideogeräte erkennen diesen Befehl.
Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der lpszCommand-Parameter wie folgt festgelegt ist.
_stprintf_s(
lpszCommand,
TEXT("update %s %s %s"),
lpszDeviceID,
lpszHDC,
lpszFlags
);
Parameter
-
lpszDeviceID
-
Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.
-
lpszHDC
-
Handle eines Domänencontrollers. In der folgenden Tabelle sind die Gerätetypen aufgeführt, die den Updatebefehl und die von den einzelnen Typen verwendeten Flags erkennen.
Wert Bedeutung Bedeutung digitalvideo hdc hdc hdc hdc at rect paint hdc hdc Die folgende Tabelle enthält die Flags, die im lpszHDC-Parameter angegeben werden können, und ihre Bedeutungen.
Wert Bedeutung hdc hdc Gibt das Handle des zu zeichnenden Domänencontrollers an. hdc hdc at rect Gibt das Clippingrechteck relativ zum Clientrechteck an. paint hdc hdc Zeichnet den DC, wenn die Anwendung eine WM _ PAINT-Nachricht empfängt, die für einen DC vorgesehen ist. Um das Handle des Domänencontrollers anzugeben, verwenden Sie die Zeichenfolge "hdc", gefolgt von einer ASCII-Darstellung des Handles. Das Rechteck wird als X1 Y1 X2 Y2 angegeben. Die Koordinaten X1 Y1 geben die obere linke Ecke des Rechtecks an, und die Koordinaten X2 Y2 geben die Breite und Höhe an.
-
lpszFlags
-
Kann "wait", "notify" oder beides sein. Für Digitalvideogeräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.
Rückgabewert
Gibt 0 (null) zurück, wenn der Fehler erfolgreich war, oder andernfalls ein Fehler.
Beispiele
Mit dem folgenden Befehl wird das gesamte Anzeigefenster aktualisiert, das vom Gerät "movie" verwendet wird. Die Zahl 203 ist ein Handle für einen Domänencontroller, der von der BeginPaint-Funktion abgerufen wurde.
update movie hdc 203
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |