Freigeben über


befehl MCI_WINDOW

Der Befehl MCI_WINDOW gibt das Fenster und die Fenstereigenschaften für Grafikgeräte an. Digitalvideo- 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 Warte-, Benachrichtigungs- und Testflags.

lpWindow

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 der Vorgang erfolgreich war oder andernfalls ein Fehler.

Bemerkungen

Grafikgeräte sollten beim Öffnen eines Geräts ein Standardfenster erstellen, es aber erst anzeigen, wenn sie den befehl MCI_PLAY erhalten. Der MCI_WINDOW-Befehl wird verwendet, um ein von der Anwendung erstelltes Fenster für das Gerät bereitzustellen und die Anzeigeeigenschaften eines anwendungsdefinierten oder Standardanzeigefensters zu ändern. Wenn die Anwendung das Anzeigefenster bereitstellt, sollte sie bereit 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 von lpWindow identifizierten Struktur enthalten.

MCI_DGV_WINDOW_STATE

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

MCI_DGV_WINDOW_TEXT

Das lpstrText-Element der von lpWindow identifizierten Struktur enthält eine Adresse eines Puffers, der die in der Fenstertitelleiste verwendeten Untertitel enthält.

Bei Digitalvideogeräten verweist der parameter lpWindow auf eine MCI_DGV_WINDOW_PARMS-Struktur .

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

MCI_OVLY_WINDOW_DISABLE_STRETCH

Deaktiviert die Dehnung des Bilds.

MCI_OVLY_WINDOW_ENABLE_STRETCH

Ermöglicht die Dehnung des Bilds.

MCI_OVLY_WINDOW_HWND

Das Handle des fensters, das für das Ziel verwendet wird, ist im hWnd-Member der von lpWindow identifizierten Struktur enthalten. Legen Sie dieses Flag auf MCI_OVLY_WINDOW_DEFAULT fest, um zum Standardfenster zurückzukehren.

MCI_OVLY_WINDOW_STATE

Das nCmdShow-Element 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 den in WINDOWS definierten Konstanten. H (z. B. SW_HIDE, SW_MINIMIZE oder SW_SHOWNORMAL).

MCI_OVLY_WINDOW_TEXT

Das lpstrText-Element der von lpWindow identifizierten Struktur enthält eine Adresse eines Puffers, der die für das Fenster verwendete Untertitel enthält.

Bei Videoüberlagerungsgeräten zeigt der lpWindow-Parameter auf eine MCI_OVLY_WINDOW_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
Mmsystem.h (einschließlich Windows.h)

Siehe auch

MCI

MCI-Befehle