MCI _ RESTORE-Befehl

Der Befehl MCI _ RESTORE kopiert eine Bitmap aus einer Datei in den Framepuffer. Digitalvideogeräte erkennen diesen Befehl. Dieser Befehl führt die entgegengesetzte Aktion des MCI _ CAPTURE-Befehls aus.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RESTORE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_RESTORE_PARMS) lpRestore
);

Parameter

wDeviceID

Gerätebezeichner des MCI-Geräts, das die Befehlsnachricht empfangen soll.

Dwflags

MCI _ NOTIFY, MCI _ WAIT oder MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

lpRestore

Zeiger auf eine MCI _ DGV _ RESTORE _ PARMS-Struktur.

Rückgabewert

Gibt 0 (null) zurück, wenn erfolgreich, andernfalls ein Fehler.

Bemerkungen

Die Implementierung kann eine Vielzahl von Bildformaten erkennen, aber eine Windows geräteunabhängige Bitmap (DEVICE-Independent Bitmap, DIB) wird immer akzeptiert.

Die folgenden zusätzlichen Flags gelten für Digitalvideogeräte:

MCI _ DGV _ RESTORE _ FROM

Der lpstrFileName-Member der durch lpRestore identifizierten Struktur enthält eine Adresse eines Puffers, der den Quelldateinamen enthält. Der Dateiname ist erforderlich.

MCI _ DGV _ RESTORE _ AT

Der rc-Member der durch lpRestore identifizierten Struktur enthält ein gültiges Rechteck. Das Rechteck gibt einen Bereich des Framepuffers relativ zum Ursprung an. Das erste Koordinatenpaar gibt die obere linke Ecke des Rechtecks an. Das zweite Paar gibt die Breite und Höhe an. Wenn dieses Flag nicht angegeben wird, wird das Bild in die obere linke Ecke des Framepuffers kopiert.

Requirements (Anforderungen)

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 (include Windows.h)

Weitere Informationen

MCI

MCI-Befehle