where-Befehl
Der Where-Befehl ruft das Rechteck ab, das den Quell- oder Zielbereich angibt. Dieses Rechteck wurde mit dem Befehl put angegeben. Digitalvideo- und Videoüberlagerungsgeräte erkennen diesen Befehl.
Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand wie folgt festgelegt ist.
_stprintf_s(
lpszCommand,
TEXT("where %s %s %s"),
lpszDeviceID,
lpszRequestRect,
lpszFlags
);
-
lpszDeviceID
-
Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.
-
lpszRequestRect
-
Flag, das das Rechteck identifiziert, dessen Dimensionen abgerufen werden. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den where-Befehl und die von jedem Typ verwendeten Flags erkennen.
Wert Bedeutung Bedeutung digitalvideo destinationdestination maxframeframe maxsource source maxvideovideo maxwindowwindow max overlay destinationframe sourcevideo In der folgenden Tabelle sind die Flags aufgeführt, die im lpszRequestRect-Parameter angegeben werden können, und ihre Bedeutungen.
Wert Bedeutung destination Ruft den Zieloffset und -ausdehnung ab. Bei Videoüberlagerungsgeräten definiert das Zielrechteck den Bereich des Clientbereichs des Anzeigefensters, in dem die Bilddaten aus dem Framepuffer angezeigt werden. destination max Ruft die aktuelle Größe des Clientrechtecks ab. frame Ruft den Offset und die Ausdehnung des Framepufferrechtecks ab. Das Framepufferrechteck definiert den Bereich des Framepuffers, der eingehende Videodaten empfängt. Bilder aus dem "Video"-Rechteck werden in diese Region skaliert. frame max Gibt die maximale Größe des Framepuffers zurück. source Ruft den Quelloffset und -ausdehnung ab. Bei Videoüberlagerungsgeräten definiert das Quellrechteck den Bereich des Framepuffers, der im Zielfenster angezeigt wird. Das Gerät verwendet dieses Rechteck, um das Bild zuzuschneiden, bevor es an das Zielrechteck auf dem Display gestreckt wird. source max Ruft die maximale Größe des Framepuffers ab. video Ruft den Offset und die Ausdehnung des Videorechtecks ab. Das Videorechteck definiert den Bereich der eingehenden Videodaten, die an den Framepuffer übertragen werden. Video max Gibt die maximale Größe der Eingabe zurück. Fenster Ruft die aktuelle Größe und Position des Anzeigefensterrahmens ab. fenster max Ruft die Größe der gesamten Anzeige ab. -
lpszFlags
-
Kann "warten", "benachrichtigen" oder beides sein. Für Digital-Video-Geräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.
Gibt ein Rechteck im lpszReturnString-Parameter der mciSendString-Funktion zurück. Das Rechteck beschreibt den Bereich, der im lpszRequestRect-Parameter dieses Befehls angegeben ist. Das Rechteck wird als X1 Y1 X2 Y2 angegeben. Die Koordinaten X1 Y1 geben die obere linke Ecke des Rechtecks an, und die Koordinaten X2 Y2 geben die Breite und Höhe an.
Der folgende Befehl gibt das Anzeigerechteck des "Movie"-Geräts zurück.
where movie destination
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |