Restore-Befehl

Der Wiederherstellungsbefehl kopiert ein Standbild aus einer Datei in den Framepuffer. Dies ist die Umkehrung des Aufzeichnungsbefehls. Digitalvideogeräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der lpszCommand-Parameter wie folgt festgelegt ist.

_stprintf_s(
  lpszCommand, 
  TEXT("restore %s %s %s"), 
  lpszDeviceID, 
  lpszRestore, 
  lpszFlags
); 

Parameter

lpszDeviceID

Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.

lpszRestore

Mindestens eines der folgenden Flags.

Wert Bedeutung
am Rechteck Gibt ein Rechteck relativ zum Framepufferursprung an. Das Rechteck wird als X1 Y1 X2 Y2 angegeben. Die Koordinaten X1 Y1 geben die obere linke Ecke und die Koordinaten X2 Y2 die Breite und Höhe an. Wenn dieses Flag nicht verwendet wird, wird das Bild in die obere linke Ecke des Rahmenpuffers kopiert.
aus Dateiname Gibt den Imagedateinamen an, der abgerufen werden soll. Dieses Flag ist erforderlich.

lpszFlags

Kann "wait", "notify", "test" oder eine Kombination dieser sein. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

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

Bemerkungen

Geräte können eine Vielzahl von Bildformaten erkennen. eine Windows geräteunabhängige Bitmap immer erkannt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]

Siehe auch

MCI

MCI-Befehlszeichenfolgen

Erfassen