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