Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 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
Behandeln sie das übergeordnete Fenster.
hInstance
Behandeln Sie die Modulinstanz, um dem MCIWnd-Fenster zuzuordnen.
dwStyle
Flags, die die Fensterformatvorlage definieren. Zusätzlich zur Angabe der Fensterformatvorlagen, die mit der CreateWindowEx--Funktion verwendet werden, können Sie die folgenden Formatvorlagen 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 Abmessungen des Zielrechtecks nicht, wenn sich die Größe eines MCIWnd-Fensters ändert. |
| MCIWNDF_NOERRORDLG | Hemmt die Anzeige von MCI-Fehlern für Benutzer. |
| MCIWNDF_NOMENU | Blendet die Menüschaltfläche in der Symbolleiste aus und verhindert, dass Benutzer auf das Popupmenü zugreifen können. |
| MCIWNDF_NOOPEN | Blendet die geöffneten und schließenden Befehle aus dem MCIWnd-Menü aus und verhindert, dass Benutzer im Popupmenü auf diese Optionen zugreifen können. |
| MCIWNDF_NOPLAYBAR | Blendet die Symbolleiste aus der Ansicht aus und verhindert, dass Benutzer darauf zugreifen. |
| MCIWNDF_NOTIFYANSI | Bewirkt, dass MCIWnd eine ANSI-Zeichenfolge anstelle einer Unicode-Zeichenfolge verwendet, wenn das übergeordnete Fenster von Gerätemodusänderungen benachrichtigt wird. Dieses Kennzeichen 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 Nachricht benachrichtigt, wenn eine Änderung der Wiedergabe- oder Datensatzposition 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 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 Größe des MCIWnd-Fensters ä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 "Datensatz" hinzu und fügt dem Menü einen neuen Dateibefehl hinzu, wenn das MCI-Gerät aufzeichnungsfähig ist. |
| MCIWNDF_SHOWALL | Bewirkt, dass alle MCIWNDF_SHOW Formatvorlagen verwendet werden. |
| MCIWNDF_SHOWMODE | Zeigt den aktuellen Modus des MCI-Geräts in der Fenstertitelleiste an. Eine Liste der Gerätemodi finden Sie im MCIWndGetMode Makros. |
| 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 innerhalb des Inhalts des MCI-Geräts in der Fenstertitelleiste an. |
szFile
Null-beendete 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 dies erfolgreich oder null ist.
Bemerkungen
Standardfensterformatvorlagen für ein untergeordnetes Fenster sind WS_CHILD, WS_BORDER und WS_VISIBLE. MCIWndCreate ein untergeordnetes Fenster an, wenn ein nichtNULL- Handle eines übergeordneten Fensters angegeben wird.
Standardfensterformatvorlagen für ein übergeordnetes Fenster sind WS_OVERLAPPEDWINDOW und WS_VISIBLE. MCIWndCreate ein übergeordnetes Fenster voraus, 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 die MCIWndRegisterClass--Funktion nicht verwendet werden.
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | vfw.h |
| Library | Vfw32.lib |
| DLL- | Msvfw32.dll |