MCIWndCreateA-Funktion (vfw.h)
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 |