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