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