MCI _ OPEN-Befehl
Der MCI _ OPEN-Befehl initialisiert ein Gerät oder eine Datei. Dieser Befehl wird von allen Geräten erkannt.
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ätebezeichner 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 ersetzen diese Struktur möglicherweise durch eine gerätespezifische Struktur.)
Rückgabewert
Gibt 0 (null) zurück, wenn erfolgreich, andernfalls ein Fehler.
Bemerkungen
Das MCI OPEN TYPE-Flag muss immer dann verwendet werden, wenn ein Gerät _ _ in der mciSendCommand-Funktion angegeben wird. Wenn Sie ein Gerät öffnen, indem Sie eine Konstante vom Typ device angeben, müssen Sie zusätzlich zu MCI OPEN TYPE das MCI _ OPEN _ TYPE ID-Flag _ _ _ angeben. Eine Liste der Gerätetypkonst konstanten finden Sie unter MCI-Gerätetypen.
Wenn das MCI OPEN SHAREABLE-Flag beim ersten Öffnen eines Geräts oder einer Datei nicht angegeben wird, können alle nachfolgenden MCI OPEN-Befehle für das Gerät oder die _ _ Datei nicht ausgeführt _ werden. Wenn das Gerät oder die Datei bereits geöffnet ist und dieses Flag nicht angegeben ist, kann der Aufruf auch dann nicht ausgeführt werden, wenn im ersten geöffneten Befehl MCI _ OPEN _ SHAREABLE angegeben wurde. Für MCISEQ geöffnete Dateien. DRV und MCIWAVE. DRV-Geräte sind nicht verfügbar.
Case wird im Gerätenamen ignoriert, es dürfen jedoch keine führenden oder nachstellenden Leerzeichen angezeigt werden.
Um die automatische Typauswahl (über die Einträge in der Registrierung) zu verwenden, weisen Sie den Dateinamen und die Dateierweiterung dem lpstrElementName-Element der durch lpOpen identifizierten Struktur zu, legen Sie den lpstrDeviceType-Member 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 -Struktur enthalten, die durch lpOpen identifiziert wird.
-
MCI _ OPEN _ SHAREABLE
-
Das Gerät oder die Datei sollte als sharable geöffnet werden.
-
MCI _ OPEN _ TYPE
-
Ein Gerätetypname oder eine Konstante ist im lpstrDeviceType-Member der struktur enthalten, die durch lpOpen identifiziert wird.
-
MCI _ OPEN _ TYPE _ ID
-
Das niedrige Wort des lpstrDeviceType-Members der durch lpOpen identifizierten Struktur enthält einen MCI-Standardgerätetypbezeichner, und das obere Wort enthält optional den Ordinalindex für das Gerät. Verwenden Sie dieses Flag mit dem MCI _ OPEN _ TYPE-Flag.
Die folgenden zusätzlichen Flags gelten für Verbundgeräte:
-
MCI _ _ OPEN-ELEMENT
-
Ein Dateiname ist im lpstrElementName-Element der -Struktur enthalten, die durch lpOpen identifiziert wird.
-
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 MCI _ OPEN _ ELEMENT-Flag.
Die folgenden zusätzlichen Flags werden mit dem Gerätetyp digitalvideo verwendet:
-
MCI _ DGV _ OPEN _ NOSTATIC
-
Das Gerät sollte die Anzahl der statischen (System-)Farben in der Palette reduzieren. Dadurch wird die Anzahl der Farben erhöht, die zum Rendern des Videostreams verfügbar sind. Dieses Flag gilt nur für Geräte, die eine Palette für Windows.
-
MCI _ DGV _ OPEN _ PARENT
-
Das handle des übergeordneten Fensters wird im hWndParent-Element der -Struktur angegeben, die durch lpOpen identifiziert wird.
-
MCI _ DGV _ OPEN _ WS
-
Ein Fensterstil wird im dwStyle-Member der -Struktur angegeben, die durch lpOpen identifiziert wird.
-
MCI _ DGV _ OPEN _ 16BIT
-
Gibt eine Einstellung für die Unterstützung von 16-Bit-MCI-Geräten an.
-
MCI _ DGV _ OPEN _ 32BIT
-
Gibt eine Einstellung für die Unterstützung von 32-Bit-MCI-Geräten an.
Bei Digitalvideogeräten verweist der lpOpen-Parameter 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 -Struktur angegeben, die durch lpOpen identifiziert wird.
-
MCI _ OVLY _ OPEN _ WS
-
Ein Fensterstil wird im dwStyle-Member der -Struktur angegeben, die durch lpOpen identifiziert wird. Der dwStyle-Wert gibt den Stil des Fensters an, das der Treiber erstellt und angibt, wenn die Anwendung keines angibt. Der style-Parameter akzeptiert eine ganze Zahl, die den Fensterstil definiert. Diese Konstanten sind identisch mit den Standardfensterstilen (z. B. WS _ CHILD, WS _ OVERLAPPEDWINDOW oder WS _ POPUP).
Bei Videoüberlagerungsgeräten verweist der lpOpen-Parameter 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-Member der -Struktur angegeben, die durch lpOpen identifiziert wird.
Bei Waveform-Audiogeräten verweist der lpOpen-Parameter auf eine MCI _ WAVE OPEN _ _ PARMS-Struktur. Der MCIWAVE-Treiber erfordert ein asynchrones Waveform-Audio-Gerä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 |
|