befehl MCI_PASTE

Der befehl MCI_PASTE fügt Daten aus der Zwischenablage in eine Datei ein. Digital-Videogeräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendCommand-Funktion mit den folgenden Parametern auf.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PASTE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_PASTE_PARMS) lpPaste
);

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.

lpPaste

Zeiger auf eine MCI_ DGV_ PASTE_ PARMS-Struktur .

Rückgabewert

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

Bemerkungen

Die folgenden zusätzlichen Flags gelten für Digital-Video-Geräte:

MCI_DGV_PASTE_AT

Ein Rechteck ist im rc-Member der durch lpPaste identifizierten Struktur enthalten. Die ersten beiden Werte des Rechtecks geben den Punkt innerhalb des Rahmens an, um die Zwischenablageinformationen zu platzieren. Wenn die Höhe und Breite des Rechtecks nicht zero sind, werden die Zwischenablageinhalte auf diese Dimensionen skaliert, wenn sie in den Rahmen eingefügt werden. Wenn das Flag nicht angegeben wird, wird MCI_PASTE standardmäßig auf das gesamte Framerechteck festgelegt.

MCI_DGV_PASTE_AUDIO_STREAM

Eine Audiostreamnummer ist im dwAudioStream-Member der durch lpPaste identifizierten Struktur enthalten. Wenn nur ein Audiostream in der Zwischenablage vorhanden ist, werden die Audiodaten in den angegebenen Stream eingefügt. Wenn mehr als ein Audiostream in der Zwischenablage vorhanden ist, gibt der Stream die Startnummer für die Streamsequenzen an. Wenn Sie dieses Flag verwenden und auch ein Video einfügen möchten, müssen Sie auch das MCI_DGV_PASTE_VIDEO_STREAM-Flag verwenden. (Wenn keines der Flags angegeben ist, werden alle Audio- und Videodatenströme ab dem ersten Audio- und Videostream eingefügt. Jeder eingefügte Stream behält seine ursprüngliche Streamnummer bei.)

MCI_DGV_PASTE_INSERT

Zwischenablagedaten sollten in den vorhandenen Arbeitsbereich an der durch das flag MCI_TO angegebenen Position eingefügt werden. Alle nach der Einfügemarke vorhandenen Daten werden in den Arbeitsbereich verschoben, um Platz zu schaffen. Dies ist die Standardeinstellung.

MCI_DGV_PASTE_OVERWRITE

Zwischenablagedaten sollten daten ersetzen, die bereits im Arbeitsbereich vorhanden sind. Die ersetzten Arbeitsbereichsdaten folgen der Einfügemarke.

MCI_DGV_PASTE_VIDEO_STREAM

Eine Videostreamnummer ist im dwVideoStream-Member der durch lpPaste identifizierten Struktur enthalten. Wenn nur ein Videostream in der Zwischenablage vorhanden ist, werden die Videodaten in den angegebenen Stream eingefügt. Wenn mehr als ein Videostream in der Zwischenablage vorhanden ist, gibt der Stream die Startnummer für die Streamsequenzen an. Wenn Sie dieses Flag verwenden und auch Audio einfügen möchten, müssen Sie auch das MCI_DGV_PASTE_AUDIO_STREAM-Flag verwenden. (Wenn keines der Flags angegeben ist, werden alle Audio- und Videodatenströme ab dem ersten Audio- und Videostream eingefügt. Jeder eingefügte Stream behält seine ursprüngliche Streamnummer bei.)

MCI_TO

Ein Positionswert ist im dwTo-Element der durch lpPaste identifizierten Struktur enthalten. Der Positionswert gibt die Position an, an der Daten in den Arbeitsbereich eingefügt werden sollen. Wenn dieses Flag weggelassen wird, wird die Position standardmäßig auf die aktuelle Position festgelegt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Mmsystem.h (einschließlich Windows.h)

Weitere Informationen

MCI

MCI-Befehle