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]

Weitere Informationen

MCI

MCI-Befehlszeichenfolgen