befehl MCI_OPEN

Der Befehl MCI_OPEN initialisiert ein Gerät oder eine Datei. Alle Geräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendCommand-Funktion mit den folgenden Parametern auf.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_OPEN, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_OPEN_PARMS) lpOpen
);

Parameter

wDeviceID

Geräte-ID des MCI-Geräts, das die Befehlsnachricht empfangen soll.

dwFlags

MCI_NOTIFY oder MCI_WAIT. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

lpOpen

Zeiger auf eine MCI_OPEN_PARMS-Struktur . (Geräte mit erweiterten Befehlssätzen können diese Struktur durch eine gerätespezifische Struktur ersetzen.)

Rückgabewert

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

Bemerkungen

Das flag MCI_OPEN_TYPE muss immer verwendet werden, wenn ein Gerät in der mciSendCommand-Funktion angegeben wird. Wenn Sie ein Gerät öffnen, indem Sie eine Gerätetypkonstante angeben, müssen Sie zusätzlich zu MCI_OPEN_TYPE das flag MCI_OPEN_TYPE_ID angeben. Eine Liste der Gerätetypkonstanten finden Sie unter MCI-Gerätetypen.

Wenn das MCI_OPEN_SHAREABLE-Flag beim ersten Öffnen eines Geräts oder einer Datei nicht angegeben wird, schlagen alle nachfolgenden MCI_OPEN Befehle für das Gerät oder die Datei fehl. Wenn das Gerät oder die Datei bereits geöffnet ist und dieses Flag nicht angegeben ist, schlägt der Aufruf auch dann fehl, wenn der erste geöffnete Befehl MCI_OPEN_SHAREABLE. Dateien, die für den MCISEQ geöffnet wurden. DRV und MCIWAVE. DRV-Geräte sind nicht zu beharren.

Die Groß-/Kleinschreibung wird im Gerätenamen ignoriert, es können jedoch keine führenden oder nachfolgenden Leerzeichen vorhanden sein.

Um die automatische Typauswahl (über die Einträge in der Registrierung) zu verwenden, weisen Sie den Dateinamen und die Dateierweiterung dem lpstrElementName-Member der durch lpOpen identifizierten Struktur zu, legen Sie das lpstrDeviceType-Element auf NULL fest, und legen Sie das MCI_OPEN_ELEMENT-Flag fest.

Die folgenden zusätzlichen Flags gelten für alle Geräte, die MCI_OPEN unterstützen:

MCI_OPEN_ALIAS

Ein Alias ist im lpstrAlias-Member der durch lpOpen identifizierten Struktur enthalten.

MCI_OPEN_SHAREABLE

Das Gerät oder die Datei sollte als teilbar geöffnet werden.

MCI_OPEN_TYPE

Ein Gerätetypname oder eine Konstante ist im lpstrDeviceType-Member der durch lpOpen identifizierten Struktur enthalten.

MCI_OPEN_TYPE_ID

Das Wort mit niedriger Ordnung des lpstrDeviceType-Elements der durch lpOpen identifizierten Struktur enthält einen MCI-Standard-Gerätetypbezeichner, und das Wort mit hoher Ordnung enthält optional den Ordnungsindex für das Gerät. Verwenden Sie dieses Flag mit dem flag MCI_OPEN_TYPE.

Die folgenden zusätzlichen Flags gelten für Verbundgeräte:

MCI_OPEN_ELEMENT

Ein Dateiname ist im lpstrElementName-Element der durch lpOpen identifizierten Struktur enthalten.

MCI_OPEN_ELEMENT_ID

Der lpstrElementName-Member der durch lpOpen identifizierten Struktur wird als DWORD-Wert interpretiert und hat eine interne Bedeutung für das Gerät. Verwenden Sie dieses Flag mit dem flag MCI_OPEN_ELEMENT.

Die folgenden zusätzlichen Flags werden mit dem Digitalvideo-Gerätetyp verwendet:

MCI_DGV_OPEN_NOSTATIC

Das Gerät sollte die Anzahl der statischen (System-)Farben in der Palette reduzieren. Dadurch erhöht sich die Anzahl der Farben, die zum Rendern des Videostreams verfügbar sind. Dieses Flag gilt nur für Geräte, die eine Palette mit Windows gemeinsam nutzen.

MCI_DGV_OPEN_PARENT

Das Handle des übergeordneten Fensters wird im hWndParent-Element der durch lpOpen identifizierten Struktur angegeben.

MCI_DGV_OPEN_WS

Im dwStyle-Element der durch lpOpen identifizierten Struktur wird ein Fensterformat angegeben.

MCI_DGV_OPEN_16BIT

Gibt eine Einstellung für die 16-Bit-MCI-Geräteunterstützung an.

MCI_DGV_OPEN_32BIT

Gibt eine Einstellung für die 32-Bit-MCI-Geräteunterstützung an.

Bei Digital-Video-Geräten verweist der parameter lpOpen auf eine MCI_DGV_OPEN_PARMS-Struktur .

Die folgenden zusätzlichen Flags werden mit dem Überlagerungsgerätetyp verwendet:

MCI_OVLY_OPEN_PARENT

Das Handle des übergeordneten Fensters wird im hWndParent-Element der durch lpOpen identifizierten Struktur angegeben.

MCI_OVLY_OPEN_WS

Im dwStyle-Element der durch lpOpen identifizierten Struktur wird ein Fensterformat angegeben. Der dwStyle-Wert gibt den Stil des Fensters an, das der Treiber erstellt und anzeigt, wenn die Anwendung keines bereitstellt. Der style-Parameter verwendet eine ganze Zahl, die die Fensterformatvorlage definiert. Diese Konstanten sind identisch mit den Standardfensterstilen (z. B. WS_CHILD, WS_OVERLAPPEDWINDOW oder WS_POPUP).

Bei Videoüberlagerungsgeräten verweist der parameter lpOpen auf eine MCI_OVLY_OPEN_PARMS-Struktur .

Das folgende zusätzliche Flag wird mit dem Waveaudio-Gerätetyp verwendet:

MCI_WAVE_OPEN_BUFFER

Eine Pufferlänge wird im dwBufferSeconds-Element der durch lpOpen identifizierten Struktur angegeben.

Bei Waveform-Audiogeräten verweist der parameter lpOpen auf eine MCI_WAVE_OPEN_PARMS-Struktur . 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	Mmsystem.h (windows.h einschließen)

Weitere Informationen

MCI

MCI-Befehle