befehl MCI_PUT
Der Befehl MCI_PUT legt die Quell-, Ziel- und Framerechtecke fest. Digital-Video- und Video-Overlay-Geräte erkennen diesen Befehl.
Um diesen Befehl zu senden, rufen Sie die mciSendCommand-Funktion mit den folgenden Parametern auf.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_PUT,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpDest
);
-
wDeviceID
-
Geräte-ID des MCI-Geräts, das die Befehlsnachricht empfangen soll.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT oder bei Digital-Video-Geräten MCI_TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.
-
lpDest
-
Zeiger auf eine MCI_GENERIC_PARMS-Struktur . (Geräte mit erweiterten Befehlssätzen können diese Struktur durch eine gerätespezifische Struktur ersetzen.)
Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.
Die folgenden zusätzlichen Flags werden mit dem Digitalvideo-Gerätetyp 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 diesem Gerätetreiber instance zugeordnet ist, der das Bild oder Video zeigt.
-
MCI_DGV_PUT_FRAME
-
Das für MCI_DGV_RECT definierte Rechteck gilt für das Framerechteck. Das Framerechteck 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 Framepufferrechteck passt.
Das Rechteck wird in Framepufferkoordinaten angegeben. Das Standardrechteck ist der Vollbildpuffer. 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, lehnen diesen Befehl mit MCIERR_UNSUPPORTED_FUNCTION ab. Sie können das MCI_GETDEVCAPS_CAN_STRETCH-Flag mit dem Befehl MCI_GETDEVCAPS verwenden, um zu bestimmen, ob ein Gerät das Bild skaliert. Ein Gerät gibt FALSE zurück, wenn das Bild nicht skaliert werden kann.
-
MCI_DGV_PUT_SOURCE
-
Das für MCI_DGV_RECT definierte Rechteck gibt ein Quellrechteck an. Das Quellrechteck gibt an, welcher Teil des Framepuffers 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 ist. Das Rechteck wird mithilfe der natürlichen Koordinaten der Präsentationsquelle angegeben. Es ermöglicht die Spezifikation des Zuschneidens, das vor dem Speichern von Bildern und Videos im Framepuffer erfolgt. Das Standardrechteck ist der vollständig 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 anfängliche Fenstergröße und -position verwendet.
-
MCI_DGV_RECT
-
Das rc-Element der durch lpDest identifizierten Struktur enthält ein gültiges Rechteck.
Bei Digital-Video-Geräten 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, das zum Anzeigen eines Bilds verwendet wird. Das Rechteck enthält den Offset und den sichtbaren Bereich des Bilds relativ zum Fensterursprung. Wenn der Frame gestreckt wird, wird die Quelle bis zum 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 die Ausdehnung des Pufferbereichs relativ zum Videopufferursprung.
-
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 die Ausdehnung des Beschneidungsrechtecks für den Videopuffer relativ zum Ursprung.
-
MCI_OVLY_PUT_VIDEO
-
Das für MCI_OVLY_RECT definierte Rechteck gibt den Bereich der Videoquellenaufnahme durch den Videopuffer an. Das Rechteck enthält den Offset und den Umfang des Beschneidungsrechtecks für die Videoquelle relativ zum Ursprung.
-
MCI_OVLY_RECT
-
Der rc-Member der durch 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 verweist lpDest auf eine MCI_OVLY_RECT_PARMS-Struktur .
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
Header |
|