MCI _ PUT-Befehl
Der MCI _ PUT-Befehl legt die Quell-, Ziel- und Rahmenrechtecke fest. Digitale Video- und Videoüberlagerungsgeräte erkennen diesen Befehl.
Rufen Sie zum Senden dieses Befehls die mciSendCommand-Funktion mit den folgenden Parametern auf.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_PUT,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpDest
);
Parameter
-
wDeviceID
-
Gerätebezeichner des MCI-Geräts, das die Befehlsmeldung empfangen soll.
-
Dwflags
-
MCI _ NOTIFY, MCI _ WAIT oder, für Digital Video-Geräte, MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.
-
lpDest
-
Zeiger auf eine GENERISCHE _ MCI-PARMS-Struktur. _ (Geräte mit erweiterten Befehlssätzen können diese Struktur durch eine gerätespezifische Struktur ersetzen.)
Rückgabewert
Gibt 0 (null) zurück, wenn der Fehler erfolgreich war, oder andernfalls ein Fehler.
Bemerkungen
Die folgenden zusätzlichen Flags werden mit dem Gerätetyp digitalvideo verwendet:
-
MCI _ DGV _ PUT _ CLIENT
-
Das für MCI DGV RECT definierte Rechteck _ gilt für die Position des _ Clientfensters. Das angegebene Rechteck ist relativ zum übergeordneten Fenster des Anzeigefensters. MCI _ DGV _ PUT WINDOW muss gleichzeitig mit diesem Flag festgelegt _ werden.
-
MCI _ DGV _ PUT _ DESTINATION
-
Das für MCI DGV RECT definierte Rechteck _ _ gibt ein Zielrechteck an. Das Zielrechteck gibt den Teil des Clientfensters an, der dieser Gerätetreiberinstanz zugeordnet ist und das Bild oder Video anzeigt.
-
MCI _ DGV _ PUT _ FRAME
-
Das für MCI DGV RECT definierte Rechteck _ _ gilt für das Rahmenrechteck. Das Rahmenrechteck gibt den Teil des Framepuffers an, der als Ziel der Videobilder verwendet wird, die aus dem Videorechteck abgerufen werden. Das Video sollte so skaliert werden, dass es in das Rahmenpufferrechteck passt.
Das Rechteck wird in Framepufferkoordinaten angegeben. Das Standardrechteck ist der vollständige Framepuffer. Wenn Sie dieses Rechteck angeben, kann das Gerät das Bild skalieren, während es die Daten digitalisiert. Geräte, die das Image nicht skalieren können, weisen diesen Befehl mit MCIERR _ UNSUPPORTED _ FUNCTION zurück. Sie können das MCI _ GETDEVCAPS _ CAN _ STRETCH-Flag mit dem MCI _ GETDEVCAPS-Befehl verwenden, um zu bestimmen, ob ein Gerät das Image skaliert. Ein Gerät gibt FALSE zurück, wenn es das Image nicht skalieren kann.
-
MCI _ DGV _ PUT _ SOURCE
-
Das für MCI DGV RECT definierte Rechteck _ _ gibt ein Quellrechteck an. Das Quellrechteck gibt an, welcher Teil des Rahmenpuffers skaliert werden soll, um in das Zielrechteck zu passen.
-
MCI _ DGV _ PUT _ VIDEO
-
Das für MCI DGV RECT definierte Rechteck _ _ gilt für das Videorechteck. Das Videorechteck gibt an, welcher Teil der aktuellen Präsentationsquelle im Framepuffer gespeichert wird. Das Rechteck wird mithilfe der natürlichen Koordinaten der Präsentationsquelle angegeben. Sie ermöglicht die Angabe des Zuschneidens, das vor dem Speichern von Bildern und Videos im Framepuffer auftritt. Das Standardrechteck ist der vollständige aktive Scanbereich oder die vollständig dekomprimierten Bilder und Videos.
-
MCI _ DGV _ PUT _ WINDOW
-
Das für MCI DGV RECT definierte Rechteck _ _ gilt für das Anzeigefenster. Dieses Rechteck ist relativ zum übergeordneten Fenster des Anzeigefensters (normalerweise der Desktop). Wenn das Fenster nicht angegeben ist, wird standardmäßig die Anfangsfenstergröße und -position verwendet.
-
MCI _ DGV _ RECT
-
Der rc-Member der von lpDest identifizierten Struktur enthält ein gültiges Rechteck.
Für Digitalvideogeräte verweist lpDest auf eine MCI _ DGV _ PUT _ PARMS-Struktur.
Die folgenden zusätzlichen Flags werden mit dem Überlagerungsgerätetyp verwendet:
-
MCI _ OVLY _ PUT _ DESTINATION
-
Das für MCI OVLY RECT definierte Rechteck _ gibt den Bereich des _ Clientfensters an, in dem ein Bild angezeigt wird. Das Rechteck enthält den Offset und den sichtbaren Umfang des Bilds relativ zum Fensterursprung. Wenn der Rahmen gestreckt wird, wird die Quelle auf das Zielrechteck gestreckt.
-
MCI _ OVLY _ PUT _ FRAME
-
Das für MCI OVLY RECT definierte Rechteck _ gibt den Bereich des _ Videopuffers an, der zum Empfangen des Videobilds verwendet wird. Das Rechteck enthält den Offset und den Umfang des Pufferbereichs relativ zum Ursprung des Videopuffers.
-
MCI _ OVLY _ PUT _ SOURCE
-
Das für MCI OVLY RECT definierte Rechteck _ gibt den Bereich des _ Videopuffers an, der als Quelle des digitalen Bilds verwendet wird. Das Rechteck enthält den Offset und den Umfang des Clippingrechtecks für den Videopuffer relativ zum Ursprung.
-
MCI _ OVLY _ PUT _ VIDEO
-
Das für MCI OVLY RECT definierte Rechteck _ gibt den Bereich der _ Videoquellenerfassung durch den Videopuffer an. Das Rechteck enthält den Offset und den Umfang des Ausschneiderechtecks für die Videoquelle relativ zum Ursprung.
-
MCI _ OVLY _ RECT
-
Der rc-Member der von lpDest identifizierten Struktur enthält ein gültiges Anzeigerechteck. Wenn dieses Flag nicht angegeben ist, entspricht das Standardrechteck den Koordinaten des Videopuffers oder -fensters, das abgeschnitten wird.
Bei Videoüberlagerungsgeräten zeigt lpDest auf eine MCI _ OVLY _ RECT _ PARMS-Struktur.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|