befehl MCI_UPDATE

Der Befehl MCI_UPDATE aktualisiert das Anzeigerechteck. Digital-Video-Geräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendCommand-Funktion mit den folgenden Parametern auf.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_UPDATE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpDest
);

Parameter

wDeviceID: Geräte-ID des MCI-Geräts, das die Befehlsnachricht empfangen soll.
dwFlags: MCI_NOTIFY, MCI_WAIT oder bei Digital-Video-Geräten MCI_TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.
lpDest: Zeiger auf eine MCI_GENERIC_PARMS-Struktur . (Geräte mit erweiterten Befehlssätzen können diese Struktur durch eine gerätespezifische Struktur ersetzen.)

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

Die folgenden zusätzlichen Flags werden mit dem Gerätetyp "digitalvideo" verwendet:

MCI_DGV_UPDATE_HDC: Das hDC-Element der struktur, die durch lpDest identifiziert wird, enthält ein gültiges Fenster des DC zum Zeichnen. Dieses Flag ist erforderlich.
MCI_DGV_RECT: Das rc-Element der durch lpUnfreeze identifizierten Struktur enthält ein gültiges Anzeigerechteck. Das Rechteck gibt das Beschneidungsrechteck relativ zum Clientrechteck an.
MCI_DGV_UPDATE_PAINT: Eine Anwendung verwendet dieses Flag, wenn sie eine WM_PAINT Meldung empfängt, die für einen Anzeige-DC vorgesehen ist. Ein Framepuffergerät zeichnet in der Regel die Schlüsselfarbe. Wenn das Anzeigegerät über keinen Framepuffer verfügt, wird möglicherweise der Befehl MCI_UPDATE ignoriert, wenn das flag MCI_DGV_UPDATE_PAINT verwendet wird, da die Anzeige während des Wiedergabevorgangs neu gezeichnet wird.

Bei Digital-Video-Geräten verweist der parameter lpDest auf eine MCI_DGV_UPDATE_PARMS-Struktur .

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Mmsystem.h (windows.h einschließen)