Update-Befehl

Artikel
06/13/2023

Der Updatebefehl streicht den aktuellen Frame erneut in den angegebenen Gerätekontext (DEVICE Context, DC). Digital-Video-Geräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand 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 DC. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Updatebefehl und die von den einzelnen Typen verwendeten Flags erkennen.

Wert	Bedeutung	Bedeutung
digitalvideo	hdc hdc hdc hdc hdc at rect	paint hdc hdc

In der folgenden Tabelle sind die Flags aufgeführt, die im lpszHDC-Parameter angegeben werden können, und deren Bedeutung.

Wert	Bedeutung
hdc hdc	Gibt den Handle des zu zeichnenden DC an.
hdc hdc at rect	Gibt das Beschneidungsrechteck 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 DC anzugeben, verwenden Sie die Zeichenfolge "hdc" gefolgt von einer ASCII-Darstellung des Handles. Das Rechteck wird alsX1 Y1 X2 Y2 angegeben. Die KoordinatenX1 Y1geben die obere linke Ecke des Rechtecks an, und die KoordinatenX2 Y2geben die Breite und Höhe an.

lpszFlags

Kann "warte", "benachrichtigen" oder beides sein. Für Digital-Video-Geräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Beispiele

Der folgende Befehl aktualisiert das gesamte Anzeigefenster, das vom "Movie"-Gerät verwendet wird. Die Zahl 203 ist ein Handle für einen DC, der von der BeginPaint-Funktion abgerufen wird.

update movie hdc 203

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

Freigeben über