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 |
|