restore-Befehl

Artikel
06/13/2023

Der Wiederherstellungsbefehl kopiert ein Standbild aus einer Datei in den Framepuffer. Dies ist die Umgekehrte des Capture-Befehls . Digital-Videogeräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand 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 an, und die Koordinaten X2 Y2 geben die Breite und Höhe an. Wenn dieses Flag nicht verwendet wird, wird das Bild in die obere linke Ecke des Framepuffers kopiert.
aus Dateiname	Gibt den Imagedateinamen an, der abgerufen werden soll. Dieses Flag ist erforderlich.

lpszFlags

Kann "warten", "benachrichtigen", "testen" oder eine Kombination aus diesen sein. Weitere Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

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

Bemerkungen

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

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

Freigeben über