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