Befehl "MCI _ WINDOW"

Der Befehl MCI _ WINDOW gibt das Fenster und die Fenstermerkmale für Grafikgeräte an. Digital-Video- und Videoüberlagerungsgeräte erkennen diesen Befehl.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_WINDOW, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpWindow
);

Parameter

wDeviceID

Gerätebezeichner des MCI-Geräts, das die Befehlsnachricht empfangen soll.

Dwflags

MCI _ NOTIFY, MCI _ WAIT oder für Digitalvideogeräte MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

lpWindow

Zeiger auf eine MCI _ GENERIC _ PARMS-Struktur. (Geräte mit erweiterten Befehlssätzen ersetzen diese Struktur möglicherweise durch eine gerätespezifische Struktur.)

Rückgabewert

Gibt 0 (null) zurück, wenn erfolgreich, andernfalls ein Fehler.

Bemerkungen

Grafikgeräte sollten beim Öffnen eines Geräts ein Standardfenster erstellen, es jedoch erst anzeigen, wenn sie den MCI _ PLAY-Befehl erhalten. Mit dem Befehl MCI WINDOW wird ein von der Anwendung erstelltes Fenster für das Gerät angegeben und die Anzeigemerkmale eines anwendungsdefinierten oder _ Standardanzeigefensters geändert. Wenn die Anwendung das Anzeigefenster angibt, sollte sie darauf vorbereitet sein, ein ungültiges Rechteck im Fenster zu aktualisieren.

Die folgenden zusätzlichen Flags werden mit dem Gerätetyp digitalvideo verwendet:

MCI _ DGV _ WINDOW _ HWND

Das Handle des Fensters, das für die Verwendung als Ziel benötigt wird, ist im hWnd-Member der -Struktur enthalten, die durch lpWindow identifiziert wird.

MCI _ _ DGV-FENSTERZUSTAND _

Das nCmdShow-Member der durch lpWindow identifizierten Struktur enthält Parameter zum Festlegen des Fensterzustands.

TEXT DES MCI _ _ _ DGV-FENSTERS

Der lpstrText-Member der durch lpWindow identifizierten -Struktur enthält eine Adresse eines Puffers, der die in der Titelleiste des Fensters verwendete Beschriftung enthält.

Bei Digitalvideogeräten verweist der lpWindow-Parameter auf eine MCI _ DGV WINDOW _ _ PARMS-Struktur.

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

MCI _ OVLY _ WINDOW _ DISABLE _ STRETCH

Deaktiviert das Strecken des Bilds.

MCI _ OVLY _ WINDOW _ ENABLE _ STRETCH

Ermöglicht das Strecken des Bilds.

MCI _ OVLY _ WINDOW _ HWND

Das Handle des fensters, das für das Ziel verwendet wird, ist im hWnd-Member der -Struktur enthalten, die durch lpWindow identifiziert wird. Legen Sie dieses Flag auf MCI _ OVLY _ WINDOW _ DEFAULT fest, um zum Standardfenster zurückzukehren.

_MCI-OVLY-FENSTERZUSTAND _ _

Das nCmdShow-Member der lpWindow-Struktur enthält Parameter zum Festlegen des Fensterzustands. Dieses Flag entspricht dem Aufrufen von ShowWindow mit dem State-Parameter. Die Konstanten sind identisch mit denen, die in WINDOWS definiert sind. H (z. B. SW _ HIDE, SW _ MINIMIZE oder SW _ SHOWNORMAL).

MCI _ _ OVLY-FENSTERTEXT _

Der lpstrText-Member der durch lpWindow identifizierten -Struktur enthält eine Adresse eines Puffers, der die für das Fenster verwendete Beschriftung enthält.

Bei Videoüberlagerungsgeräten verweist der lpWindow-Parameter auf eine MCI _ OVLY _ WINDOW _ PARMS-Struktur.

Requirements (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 (include Windows.h)

Weitere Informationen

MCI

MCI-Befehle