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
);

Parameter

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.)

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Bemerkungen

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 .

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 (windows.h einschließen)

Siehe auch

MCI

MCI-Befehle