MCIWndCreateA-Funktion (vfw.h)

Artikel
03/03/2024

Die MCIWndCreate-Funktion registriert die MCIWnd-Fensterklasse und erstellt ein MCIWnd-Fenster für die Verwendung von MCI-Diensten. MCIWndCreate kann auch ein MCI-Gerät oder eine MCI-Datei (z. B. eine AVI-Datei) öffnen und dem MCIWnd-Fenster zuordnen.

Syntax

HWND VFWAPIV MCIWndCreateA(
  HWND      hwndParent,
  HINSTANCE hInstance,
  DWORD     dwStyle,
  LPCSTR    szFile
);

Parameter

hwndParent

Handle für das übergeordnete Fenster.

hInstance

Handle mit dem Modul instance, das dem MCIWnd-Fenster zugeordnet werden soll.

dwStyle

Flags, die den Fensterstil definieren. Zusätzlich zur Angabe der Fensterstile, die mit der CreateWindowEx-Funktion verwendet werden, können Sie die folgenden Stile angeben, die mit MCIWnd-Fenstern verwendet werden sollen.

Wert	Bedeutung
MCIWNDF_NOAUTOSIZEWINDOW	Ändert die Abmessungen eines MCIWnd-Fensters nicht, wenn sich die Bildgröße ändert.
MCIWNDF_NOAUTOSIZEMOVIE	Ändert die Dimensionen des Zielrechtecks nicht, wenn sich die Größe eines MCIWnd-Fensters ändert.
MCIWNDF_NOERRORDLG	Verhindert die Anzeige von MCI-Fehlern für Benutzer.
MCIWNDF_NOMENU	Blendet die Menüschaltfläche auf der Symbolleiste aus und verhindert, dass Benutzer auf das Popupmenü zugreifen können.
MCIWNDF_NOOPEN	Blendet die Befehle zum Öffnen und Schließen im MCIWnd-Menü aus und verhindert, dass Benutzer auf diese Optionen im Popupmenü zugreifen können.
MCIWNDF_NOPLAYBAR	Blendet die Ansicht der Symbolleiste aus und verhindert, dass Benutzer darauf zugreifen können.
MCIWNDF_NOTIFYANSI	Bewirkt, dass MCIWnd eine ANSI-Zeichenfolge anstelle einer Unicode-Zeichenfolge verwendet, wenn das übergeordnete Fenster über Änderungen des Gerätemodus benachrichtigt wird. Dieses Flag wird in Kombination mit MCIWNDF_NOTIFYMODE verwendet.
MCIWNDF_NOTIFYMODE	Bewirkt, dass MCIWnd das übergeordnete Fenster mit einer MCIWNDM_NOTIFYMODE-Meldung benachrichtigt, wenn das Gerät den Betriebsmodus ändert. Der lParam-Parameter dieser Nachricht identifiziert den neuen Modus, z. B. MCI_MODE_STOP.
MCIWNDF_NOTIFYPOS	Bewirkt, dass MCIWnd das übergeordnete Fenster mit einer MCIWNDM_NOTIFYPOS Meldung benachrichtigt, wenn eine Änderung der Wiedergabe- oder Aufnahmeposition innerhalb des Inhalts auftritt. Der lParam-Parameter dieser Nachricht enthält die neue Position im Inhalt.
MCIWNDF_NOTIFYMEDIA	Bewirkt, dass MCIWnd das übergeordnete Fenster mit einer MCIWNDM_NOTIFYMEDIA-Meldung benachrichtigt, wenn ein neues Gerät verwendet wird oder eine Datendatei geöffnet oder geschlossen wird. Der lParam-Parameter dieser Nachricht enthält einen Zeiger auf den neuen Dateinamen.
MCIWNDF_NOTIFYSIZE	Bewirkt, dass MCIWnd das übergeordnete Fenster benachrichtigt, wenn sich die MCIWnd-Fenstergröße ändert.
MCIWNDF_NOTIFYERROR	Bewirkt, dass MCIWnd das übergeordnete Fenster benachrichtigt, wenn ein MCI-Fehler auftritt.
MCIWNDF_NOTIFYALL	Bewirkt, dass alle MCIWNDF-Fensterbenachrichtigungsstile verwendet werden.
MCIWNDF_RECORD	Fügt der Symbolleiste eine Schaltfläche Aufzeichnen hinzu und fügt dem Menü einen neuen Dateibefehl hinzu, wenn das MCI-Gerät über Aufzeichnungsfunktionen verfügt.
MCIWNDF_SHOWALL	Bewirkt, dass alle MCIWNDF_SHOW Stile verwendet werden.
MCIWNDF_SHOWMODE	Zeigt den aktuellen Modus des MCI-Geräts in der Titelleiste des Fensters an. Eine Liste der Gerätemodi finden Sie im MCIWndGetMode-Makro .
MCIWNDF_SHOWNAME	Zeigt den Namen des geöffneten MCI-Geräts oder der Datendatei in der Titelleiste des MCIWnd-Fensters an.
MCIWNDF_SHOWPOS	Zeigt die aktuelle Position im Inhalt des MCI-Geräts in der Titelleiste des Fensters an.

szFile

Null-terminierte Zeichenfolge, die den Namen eines zu öffnenden MCI-Geräts oder einer Datendatei angibt.

Rückgabewert

Gibt das Handle an ein MCI-Fenster zurück, wenn der Vorgang erfolgreich war oder andernfalls null.

Hinweise

Standardfensterstile für ein untergeordnetes Fenster sind WS_CHILD, WS_BORDER und WS_VISIBLE. MCIWndCreate geht von einem untergeordneten Fenster aus, wenn ein Handle ungleich NULL eines übergeordneten Fensters angegeben wird.

Standardfensterstile für ein übergeordnetes Fenster sind WS_OVERLAPPEDWINDOW und WS_VISIBLE. MCIWndCreate geht von einem übergeordneten Fenster aus, wenn ein NULL-Handle eines übergeordneten Fensters angegeben wird.

Verwenden Sie das von dieser Funktion zurückgegebene Fensterhandle für das Fensterhandle in den MCIWnd-Makros. Wenn Ihre Anwendung diese Funktion verwendet, muss sie die MCIWndRegisterClass-Funktion nicht verwenden.

Hinweis

Der vfw.h-Header definiert MCIWndCreate als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vfw.h
Bibliothek	Vfw32.lib
DLL	Msvfw32.dll

Weitere Informationen