Open-Befehl

Der Befehl öffnen initialisiert ein Gerät. Dieser Befehl wird von allen MCI-Geräten erkannt.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand wie folgt festgelegt ist.

_stprintf_s(
  lpszCommand, 
  TEXT("open %s %s %s"), 
  lpszDevice, 
  lpszOpenFlags, 
  lpszFlags
); 

Parameter

lpszDevice

Bezeichner eines MCI-Geräts oder -Gerätetreibers. Dies kann entweder ein Gerätename (wie in der Registrierung oder in der SYSTEM.INI-Datei angegeben) oder der Dateiname des Gerätetreibers sein. Wenn Sie den Dateinamen des Gerätetreibers angeben, können Sie optional einschließen. DRV-Erweiterung, aber Sie sollten den Pfad zur Datei nicht einschließen.

lpszOpenFlags

Flag, das angibt, was initialisiert werden soll. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den geöffneten Befehl und die von den einzelnen Typen verwendeten Flags erkennen.

Wert Bedeutung Bedeutung
cdaudio Alias device_aliasSharable typ device_type
digitalvideo Alias device_aliaselementnamenostatic parent hwndsharable Formatvorlage untergeordneter Stil überlappend Popupformatvorlage style_typeTyp device_type
overlay Alias device_aliasuntergeordneten übergeordneten hwnd-Formatvorlage stilüberlappt style popup style style_typetype device_type
sequencer Alias device_alias Sharable typ device_type
Vcr Alias device_aliasSharable typ device_type
videodisk Alias device_aliasSharable typ device_type
Waveaudio alias device_aliaspuffer buffer_size device_type von Sharable-Typen

In der folgenden Tabelle sind die Flags aufgeführt, die im lpszOpenFlags-Parameter angegeben werden können, und deren Bedeutung.

Wert Bedeutung
alias device_alias Gibt einen alternativen Namen für das angegebene Gerät an. Wenn angegeben, muss es als device_id in nachfolgenden Befehlen verwendet werden.
Elementname Gibt den Namen des Geräteelements (Datei) an, das beim Öffnen des Geräts geladen wird.
puffer buffer_size Legt die Größe des Puffers in Sekunden fest, der vom Waveform-Audiogerät verwendet wird. Die Standardgröße des Puffers wird festgelegt, wenn das Waveform-Audiogerät installiert oder konfiguriert wird. In der Regel wird die Puffergröße auf 4 Sekunden festgelegt. Beim MCIWAVE-Gerät beträgt die Mindestgröße 2 Sekunden und die maximale Größe 9 Sekunden.
übergeordneter hwnd Gibt das Fensterhandle des übergeordneten Fensters an.
Freigebbar Initialisiert das Gerät oder die Datei als teilbar. Nachfolgende Versuche, das Gerät oder die Datei zu öffnen, schlagen fehl, es sei denn, Sie geben "sharable" sowohl in den ursprünglichen als auch in den nachfolgenden Open-Befehlen an. MCI gibt einen ungültigen Gerätefehler zurück, wenn das Gerät bereits geöffnet und nicht freigegeben werden kann.
Die MCISEQ-Sequencer- und MCIWAVE-Geräte unterstützen keine freigegebenen Dateien.
formatieren untergeordnetes Element Öffnet ein Fenster mit einem untergeordneten Fensterstil.
Stil überlappend Öffnet ein Fenster mit einem überlappenden Fensterstil.
Style-Popup Öffnet ein Fenster mit einem Popupfensterstil.
style style_type Gibt einen Fensterstil an.
typ device_type Gibt den Gerätetyp einer Datei an.

lpszFlags

Kann "warte", "benachrichtigen" oder beides sein. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Bemerkungen

MCI reserviert "cdaudio" für den CD-Audiogerätetyp, "videodisc" für den Videodisc-Gerätetyp, "Sequencer" für den MIDI-Sequencer-Gerätetyp, "AVIVideo" für den Gerätetyp "digital-video" und "waveaudio" für den Waveform-Audio-Gerätetyp.

Alternativ zum Flag "typ" kann MCI das Gerät basierend auf der von der Datei verwendeten Erweiterung auswählen, wie in der Registrierung oder im Abschnitt [mci-Erweiterung] der SYSTEM.INI-Datei aufgezeichnet.

MCI kann AVI-Dateien mithilfe eines Dateischnittstellenzeigers oder eines Streamschnittstellenzeigers öffnen. Um eine Datei mit einem Schnittstellenzeigertyp zu öffnen, geben Sie ein At-Zeichen (@) gefolgt vom Schnittstellenzeiger anstelle des Datei- oder Gerätenamens für den lpszDevice-Parameter an. Weitere Informationen zu den Datei- und Streamschnittstellen finden Sie unter AVIFile-Funktionen und Makros.

Mit dem folgenden Befehl wird das Gerät "mysound" geöffnet.

open new type waveaudio alias mysound buffer 6

Mit dem Gerätenamen "new" bereitet der Wellenformtreiber eine neue Wellenformressource vor. Der Befehl weist den Gerätealias "mysound" zu und gibt einen Puffer von 6 Sekunden an.

Sie können das Flag "typ" entfernen, wenn Sie den Gerätenamen mit dem Dateinamen kombinieren. MCI erkennt diese Kombination, wenn Sie die folgende Syntax verwenden:

device_name ! element_name

Das Ausrufezeichen trennt den Gerätenamen vom Dateinamen. Das Ausrufezeichen sollte nicht durch Leerzeichen getrennt werden.

Im folgenden Beispiel wird right geöffnet. WAV-Datei mit dem Gerät "waveaudio".

open waveaudio!right.wav

Der MCIWAVE-Treiber erfordert ein asynchrones Waveform-Audiogerät.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Corecrt_io.h

Siehe auch

MCI

MCI-Befehlszeichenfolgen