where-Befehl

Artikel
06/13/2023

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

Parameter

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.

Rückgabewert

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.

Beispiele

Der folgende Befehl gibt das Anzeigerechteck des "Movie"-Geräts zurück.

where movie destination

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]

Siehe auch

MCI
MCI-Befehlszeichenfolgen
put