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