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