befehl MCI_WHERE

Der Befehl MCI_WHERE ruft das Beschneidungsrechteck für das Videogerät ab. Digitalvideo- und Videoüberlagerungsgeräte erkennen diesen Befehl. Die oberen und linken Member des zurückgegebenen RECT enthalten den Ursprung des Beschneidungsrechtecks, und die rechte und die untere Member enthalten die Breite und Höhe des Beschneidungsrechtecks. (Dies ist nicht die Standardverwendung der rechten und unteren Member.)

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_WHERE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpQuery
);

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.

lpQuery

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_WHERE_DESTINATION

Ruft eine Beschreibung des rechteckigen Bereichs ab, der zum Anzeigen von Videos und Bildern im Clientbereich des aktuellen Fensters verwendet wird.

MCI_DGV_WHERE_FRAME

Ruft eine Beschreibung des rechteckigen Bereichs des Framepuffers ab, in den Bilder aus dem Videorechteck skaliert werden. Die Rechteckkoordinaten werden im rc-Element der durch lpQuery identifizierten Struktur platziert.

MCI_DGV_WHERE_MAX

Bei Verwendung mit MCI_DGV_WHERE_DESTINATION oder MCI_DGV_WHERE_SOURCE gibt das zurückgegebene Rechteck die maximale Breite und Höhe des angegebenen Bereichs an. Bei Verwendung mit MCI_DGV_WHERE_WINDOW gibt das zurückgegebene Rechteck die Größe der gesamten Anzeige an.

MCI_DGV_WHERE_SOURCE

Ruft eine Beschreibung des rechteckigen Bereichs (zugeschnitten aus dem Framepuffer) ab, der an das Zielrechteck auf der Anzeige angepasst wird.

MCI_DGV_WHERE_VIDEO

Ruft eine Beschreibung des rechteckigen Bereichs ab, der aus der Präsentationsquelle zugeschnitten ist, um das Rahmenrechteck im Framepuffer auszufüllen. Die Rechteckkoordinaten werden im rc-Element der durch lpQuery identifizierten Struktur platziert.

MCI_DGV_WHERE_WINDOW

Ruft eine Beschreibung des Anzeigefensterrahmens ab.

Bei Digital-Video-Geräten verweist der lpQuery-Parameter auf eine MCI_DGV_WHERE_PARMS-Struktur . Die MCI_DGV_WHERE_PARMS-Struktur ist mit der MCI_DGV_RECT_PARMS-Struktur identisch.

Die folgenden zusätzlichen Flags werden mit dem Überlagerungsgerätetyp verwendet:

MCI_OVLY_WHERE_DESTINATION

Ruft das Zielanzeigerechteck ab. Die Rechteckkoordinaten werden im rc-Element der durch lpQuery identifizierten Struktur platziert.

MCI_OVLY_WHERE_FRAME

Ruft das Überlagerungsrahmenrechteck ab. Die Rechteckkoordinaten werden im rc-Element der durch lpQuery identifizierten Struktur platziert.

MCI_OVLY_WHERE_SOURCE

Ruft das Quellrechteck ab. Die Rechteckkoordinaten werden im rc-Element der durch lpQuery identifizierten Struktur platziert.

MCI_OVLY_WHERE_VIDEO

Ruft das Videorechteck ab. Die Rechteckkoordinaten werden im rc-Element der durch lpQuery identifizierten Struktur platziert.

Bei Videoüberlagerungsgeräten verweist der lpQuery-Parameter 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