MCI _ GETDEVCAPS-Befehl

Der MCI _ GETDEVCAPS-Befehl ruft statische Informationen zu einem Gerät ab. Dieser Befehl wird von allen Geräten erkannt. Welche Parameter und Flags für diesen Befehl verfügbar sind, hängt vom ausgewählten Gerät ab. Informationen werden im dwReturn-Member der durch lpCapsParms identifizierten Struktur zurückgegeben.

Rufen Sie zum Senden dieses Befehls die mciSendCommand-Funktion mit den folgenden Parametern auf.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_GETDEVCAPS, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GETDEVCAPS_PARMS) lpCapsParms
);

Parameter

wDeviceID

Gerätebezeichner des MCI-Geräts, das die Befehlsmeldung empfangen soll.

Dwflags

MCI _ NOTIFY, MCI _ WAIT oder, für Digital Video- und VCR-Geräte, MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

lpCapsParms

Zeiger auf eine _ MCI-GETDEVCAPS-PARMS-Struktur. _

Rückgabewert

Gibt 0 (null) zurück, wenn der Fehler erfolgreich war, oder andernfalls ein Fehler.

Bemerkungen

Die folgenden zusätzlichen standard- und befehlsspezifischen Flags gelten für alle Geräte, die MCI _ GETDEVCAPS unterstützen:

MCI _ GETDEVCAPS _ COMPOUND _ DEVICE

Der dwReturn-Member wird auf TRUE festgelegt, wenn das Gerät Datenspeicherung verwendet, die explizit geöffnet und geschlossen werden muss. andernfalls ist sie auf FALSE festgelegt.

MCI _ _ GETDEVCAPS-GERÄTETYP _

Der dwReturn-Member wird auf einen der Werte festgelegt, die unter MCI-Gerätetypenaufgeführt sind.

MCI _ GETDEVCAPS _ VERFÜGT ÜBER _ AUDIO

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät über eine Audioausgabe verfügt. andernfalls ist sie auf FALSE festgelegt.

MCI _ GETDEVCAPS _ HAT _ VIDEO

Der dwReturn-Member wird auf TRUE festgelegt, wenn das Gerät über eine Videoausgabe verfügt. andernfalls ist sie auf FALSE festgelegt. Beispielsweise wird der Member für Geräte, die den Videodisc-Befehlssatz unterstützen, auf TRUE festgelegt.

MCI _ GETDEVCAPS-ELEMENT _

Gibt an, dass der dwItem-Member der MCI _ GETDEVCAPS _ PARMS-Struktur eine der folgenden Konstanten enthält:

MCI _ GETDEVCAPS _ KANN _ AUSWERFEN

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät das Medium auswerfen kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ GETDEVCAPS _ KANN WIEDERGEGEBEN _ WERDEN

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät die Medien wiedergeben kann. Andernfalls wird sie auf FALSE festgelegt. Wenn ein Gerät TRUE angibt, impliziert dies, dass das Gerät die Befehle MCI _ PAUSE und MCI _ STOP sowie den MCI _ PLAY-Befehl unterstützt.

MCI _ GETDEVCAPS _ CAN _ RECORD

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät die Aufzeichnung unterstützt. Andernfalls wird sie auf FALSE festgelegt. Wenn ein Gerät TRUE angibt, impliziert dies, dass das Gerät die Befehle MCI _ PAUSE und MCI STOP sowie den _ MCI _ RECORD-Befehl unterstützt.

MCI _ GETDEVCAPS _ KANN GESPEICHERT _ WERDEN

Das dwReturn-Element ist auf TRUE festgelegt, wenn das Gerät eine Datei speichern kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ GETDEVCAPS _ VERWENDET _ DATEIEN

Das dwReturn-Element wird auf TRUE festgelegt, wenn das Gerät einen Dateinamen erfordert. andernfalls ist sie auf FALSE festgelegt. Nur Verbundgeräte verwenden Dateien.

Die folgenden Flags können im dwItem-Member von MCI _ GETDEVCAPS _ PARMS für den Digitalvideo-Gerätetyp angegeben werden:

MCI _ DGV _ GETDEVCAPS _ KANN _ EINFRIEREN

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät Frames einfrieren kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ DGV _ GETDEVCAPS _ CAN _ LOCK

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät gesperrt werden kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ DGV _ GETDEVCAPS _ KANN _ UMKEHREN

Der dwReturn-Member wird auf TRUE festgelegt, wenn das Gerät umgekehrt wiedergegeben werden kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ DGV _ GETDEVCAPS _ CAN _ STR _ IN

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät Eingaben strecken kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ DGV _ GETDEVCAPS _ CAN _ STRETCH

Das dwReturn-Element wird auf TRUE festgelegt, wenn das Gerät ein Bild strecken kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ DGV _ GETDEVCAPS _ KANN _ TESTEN

Das dwReturn-Element ist auf TRUE festgelegt, wenn das Gerät Tests ausführen kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ DGV _ GETDEVCAPS _ HAT _ NOCH

Das dwReturn-Element ist auf TRUE festgelegt, wenn das Gerät Standbilder anzeigen kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ DGV _ GETDEVCAPS _ MAX _ WINDOWS

Der dwReturn-Member wird auf die maximale Anzahl von Fenstern festgelegt, die das Gerät gleichzeitig verarbeiten kann.

MCI _ DGV _ GETDEVCAPS _ MAXIMUM _ RATE

Der dwReturn-Member wird auf die maximale Wiedergaberate für das Gerät in Frames pro Sekunde festgelegt.

MINDESTRATE FÜR MCI _ DGV _ GETDEVCAPS _ _

Das dwReturn-Element wird auf die minimale Wiedergaberate für das Gerät in Frames pro Sekunde festgelegt.

MCI _ DGV _ GETDEVCAPS _ PALETTEN

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät ein Palettenhandle zurückgeben kann. Andernfalls wird sie auf FALSE festgelegt.

Die folgenden Flags können im dwItem-Member von MCI _ GETDEVCAPS _ PARMS für den vcr-Gerätetyp angegeben werden:

MCI _ GETDEVCAPS _ CLOCK _ INCREMENT _ RATE

Das dwReturn-Element wird auf die Anzahl der Inkremente pro Sekunde festgelegt.

MCI _ VCR _ GETDEVCAPS _ KANN _ LÄNGE ERKENNEN _

Der dwReturn-Member wird auf TRUE festgelegt, wenn das Gerät die Länge des Mediums erkennen kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ VCR _ GETDEVCAPS _ KANN _ EINFRIEREN

Der dwReturn-Member wird auf TRUE festgelegt, wenn das Gerät in der Lage ist, das Ausgabebild einzufrieren. Andernfalls wird sie auf FALSE festgelegt.

MCI _ VCR _ GETDEVCAPS _ KANN _ QUELLEN ÜBERWACHEN _

Der dwReturn-Member wird auf TRUE festgelegt, wenn das Gerät Quellen überwachen kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ VCR _ GETDEVCAPS _ CAN _ PREROLL

Der dwReturn-Member wird auf TRUE festgelegt, wenn das Gerät eine Vorabrolling ermöglicht. Andernfalls wird sie auf FALSE festgelegt.

MCI _ VCR _ GETDEVCAPS _ CAN _ PREVIEW

Das dwReturn-Element wird auf TRUE festgelegt, wenn das Gerät vorschaufähig ist. Andernfalls wird sie auf FALSE festgelegt.

MCI _ VCR _ GETDEVCAPS _ KANN _ UMKEHREN

Der dwReturn-Member wird auf TRUE festgelegt, wenn das Gerät umgekehrt wiedergegeben werden kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ VCR _ GETDEVCAPS _ KANN _ TESTEN

Der dwReturn-Member wird auf TRUE festgelegt, wenn das Gerät getestet werden kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ VCR _ GETDEVCAPS _ HAT _ UHR

Das dwReturn-Element wird auf TRUE festgelegt, wenn das Gerät eine externe Uhr unterstützt. Andernfalls wird sie auf FALSE festgelegt.

MCI _ VCR _ GETDEVCAPS _ HAT _ TIMECODE

Der dwReturn-Member wird auf TRUE festgelegt, wenn das Gerät über eine Timecodefunktion verfügt oder diese Funktion unbekannt ist. Andernfalls wird sie auf FALSE festgelegt.

MCI _ VCR _ GETDEVCAPS _ NUMBER _ OF _ MARKS

Das dwReturn-Element wird auf die Anzahl der Markierungen (99) festgelegt.

MCI _ VCR _ GETDEVCAPS _ SEEK _ ACCURACY

Das dwReturn-Element wird auf die Suchgenauigkeit des Geräts festgelegt.

Die folgenden Flags können im dwItem-Member von MCI _ GETDEVCAPS _ PARMS für den Overlaygerätetyp angegeben werden:

MCI _ OVLY _ GETDEVCAPS _ KANN _ EINFRIEREN

Das dwReturn-Element wird auf TRUE festgelegt, wenn das Gerät das Image einfrieren kann. Andernfalls wird sie auf FALSE festgelegt.

MCI _ OVLY _ GETDEVCAPS _ CAN _ STRETCH

Das dwReturn-Element wird auf TRUE festgelegt, wenn das Gerät das Bild strecken kann, um den Frame zu füllen. Andernfalls wird sie auf FALSE festgelegt.

MCI _ OVLY _ GETDEVCAPS _ MAX _ WINDOWS

Der dwReturn-Member wird auf die maximale Anzahl von Fenstern festgelegt, die das Gerät gleichzeitig verarbeiten kann.

Die folgenden Flags können im dwItem-Member von MCI _ GETDEVCAPS _ PARMS für den Gerätetyp videodisc angegeben werden:

MCI _ VD _ GETDEVCAPS _ KANN _ UMKEHREN

Der dwReturn-Member wird auf TRUE festgelegt, wenn der Videodisc-Player umgekehrt wiedergegeben werden kann. Andernfalls wird sie auf FALSE festgelegt. Einige Player können CLV-Datenträger in umgekehrter Reihenfolge sowie CAV-Datenträger wiedergeben.

MCI _ VD _ GETDEVCAPS _ CAV

Gibt in Kombination mit anderen Elementen an, dass die Rückgabeinformationen für videodiscs im CAV-Format gelten. Dies ist die Standardeinstellung, wenn keine videodisc eingefügt wird.

MCI _ VD _ GETDEVCAPS _ CLV

Gibt in Kombination mit anderen Elementen an, dass die Rückgabeinformationen für videodiscs im CLV-Format gelten.

MCI _ VD _ GETDEVCAPS _ FAST _ RATE

Das dwReturn-Element wird auf die standardmäßige schnelle Wiedergaberate in Frames pro Sekunde festgelegt.

MCI _ VD _ GETDEVCAPS _ NORMAL _ RATE

Der dwReturn-Member wird auf die normale Wiedergaberate in Frames pro Sekunde festgelegt.

MCI _ VD _ GETDEVCAPS _ SLOW _ RATE

Der dwReturn-Member wird auf die standard langsame Wiedergaberate in Frames pro Sekunde festgelegt.

Die folgenden Flags können im dwItem-Member von MCI _ GETDEVCAPS _ PARMS für den Waveaudio-Gerätetyp angegeben werden:

MCI _ WAVE _ GETDEVCAPS _ INPUT

Das dwReturn-Element wird auf die Gesamtzahl der Geräte für die Wellenformeingabe (Aufzeichnung) festgelegt.

MCI _ WAVE _ GETDEVCAPS-AUSGABE _

Das dwReturn-Element wird auf die Gesamtzahl der Waveformausgabegeräte (Wiedergabegeräte) festgelegt.

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 (include Windows.h)

Siehe auch

MCI

MCI-Befehle