befehl MCI_RESTORE

Der MCI_RESTORE-Befehl kopiert eine Bitmap aus einer Datei in den Framepuffer. Digital-Videogerä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 Warte-, Benachrichtigungs- und Testflags.

lpRestore

Zeiger auf eine MCI_DGV_RESTORE_PARMS-Struktur .

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.

Bemerkungen

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

Die folgenden zusätzlichen Flags gelten für Digital-Video-Geräte:

MCI_DGV_RESTORE_FROM

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

MCI_DGV_RESTORE_AT

Das rc-Element 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 ist, wird das Bild in die obere linke Ecke des Framepuffers kopiert.

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 (einschließlich Windows.h)

Siehe auch

MCI

MCI-Befehle