Auf Englisch lesen

Freigeben über


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

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