Capture-Befehl

  • Artikel

Der Capture-Befehl kopiert den Inhalt des Framepuffers und speichert ihn in der angegebenen Datei. 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("capture %s %s %s"), 
  lpszDeviceID, 
  lpszCapture, 
  lpszFlags
);

Parameter

lpszDeviceID

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

lpszCapture

Mindestens eins der folgenden Flags:

Wert Bedeutung
als Pfadname Gibt den Zielpfad und dateinamen für das erfasste Image an. Dieses Flag ist erforderlich.
am Rechteck Gibt den rechteckigen Bereich innerhalb des Framepuffers an, den das Gerät zuschneidet und auf dem Datenträger speichert. Wenn er nicht angegeben wird, wird für den zuschneidenden Bereich standardmäßig das Rechteck verwendet, das bei einem vorherigen Befehl "source" für dieses Gerät instance angegeben oder standardmäßig angegeben wurde.

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

Dieser Befehl schlägt möglicherweise fehl, wenn das Gerät derzeit Bewegungsvideos abspielt oder einen anderen ressourcenintensiven Vorgang ausführt. Wenn der Framepuffer in Echtzeit aktualisiert wird, wird die Aktualisierung vorübergehend angehalten, sodass ein vollständiges Bild erfasst wird. Wenn das Gerät die Aktualisierung anhält, kann es zu einem visuellen oder akustischen Effekt kommen. Wenn das Dateiformat, der Komprimierungsalgorithmus und die Qualitätsebenen nicht festgelegt wurden, werden ihre Standardwerte verwendet.

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

put