befehl MCI_GETDEVCAPS

Der befehl MCI_GETDEVCAPS ruft statische Informationen zu einem Gerät ab. Alle Geräte erkennen diesen Befehl. Die für diesen Befehl verfügbaren Parameter und Flags hängen vom ausgewählten Gerät ab. Informationen werden im dwReturn-Member der von lpCapsParms identifizierten Struktur zurückgegeben.

Um diesen Befehl zu senden, rufen Sie 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 Befehlsnachricht empfangen soll.

dwFlags

MCI_NOTIFY, MCI_WAIT oder für Digitalvideo- und Videorekordergeräte MCI_TEST. Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.

lpCapsParms

Zeiger auf eine MCI_GETDEVCAPS_PARMS-Struktur .

Rückgabewert

Gibt null zurück, wenn der Vorgang 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 ist auf TRUE festgelegt, wenn das Gerät einen Datenspeicher verwendet, der explizit geöffnet und geschlossen werden muss. Andernfalls ist sie auf FALSE festgelegt.

MCI_GETDEVCAPS_DEVICE_TYPE

Das dwReturn-Element ist auf einen der Werte festgelegt, die unter MCI-Gerätetypen aufgeführt sind.

MCI_GETDEVCAPS_HAS_AUDIO

Das dwReturn-Element ist auf TRUE festgelegt, wenn das Gerät über eine Audioausgabe verfügt. Andernfalls ist sie auf FALSE festgelegt.

MCI_GETDEVCAPS_HAS_VIDEO

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät über eine Videoausgabe verfügt. Andernfalls ist sie auf FALSE festgelegt. Für Geräte, die den videodisc-Befehlssatz unterstützen, ist das Element beispielsweise auf TRUE festgelegt.

MCI_GETDEVCAPS_ITEM

Gibt an, dass das dwItem-Element der MCI_GETDEVCAPS_PARMS-Struktur eine der folgenden Konstanten enthält:

MCI_GETDEVCAPS_CAN_EJECT

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

MCI_GETDEVCAPS_CAN_PLAY

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät die Medien wiedergeben kann. Andernfalls ist er auf FALSE festgelegt. Wenn ein Gerät TRUE angibt, bedeutet dies, dass das Gerät die befehle MCI_PAUSE und MCI_STOP sowie den Befehl MCI_PLAY unterstützt.

MCI_GETDEVCAPS_CAN_RECORD

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät die Aufzeichnung unterstützt. Andernfalls ist er auf FALSE festgelegt. Wenn ein Gerät TRUE angibt, bedeutet dies, dass das Gerät die befehle MCI_PAUSE und MCI_STOP sowie den Befehl MCI_RECORD unterstützt.

MCI_GETDEVCAPS_CAN_SAVE

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät eine Datei speichern kann. Andernfalls ist er auf FALSE festgelegt.

MCI_GETDEVCAPS_USES_FILES

Das dwReturn-Element ist auf TRUE festgelegt, wenn das Gerät einen Dateinamen benötigt. Andernfalls ist sie auf FALSE festgelegt. Nur zusammengesetzte Gerä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_CAN_FREEZE

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

MCI_DGV_GETDEVCAPS_CAN_LOCK

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät sperren kann. Andernfalls ist er auf FALSE festgelegt.

MCI_DGV_GETDEVCAPS_CAN_REVERSE

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

MCI_DGV_GETDEVCAPS_CAN_STR_IN

Das dwReturn-Element ist auf TRUE festgelegt, wenn das Gerät eingaben kann. Andernfalls ist er auf FALSE festgelegt.

MCI_DGV_GETDEVCAPS_CAN_STRETCH

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät ein Bild strecken kann. Andernfalls ist er auf FALSE festgelegt.

MCI_DGV_GETDEVCAPS_CAN_TEST

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

MCI_DGV_GETDEVCAPS_HAS_STILL

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät Standbilder anzeigen kann. Andernfalls ist er auf FALSE festgelegt.

MCI_DGV_GETDEVCAPS_MAX_WINDOWS

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

MCI_DGV_GETDEVCAPS_MAXIMUM_RATE

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

MCI_DGV_GETDEVCAPS_MINIMUM_RATE

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

MCI_DGV_GETDEVCAPS_PALETTES

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät ein Palettenhandle zurückgeben kann. Andernfalls ist er 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

Der dwReturn-Member ist auf die Anzahl der Inkremente pro Sekunde festgelegt.

MCI_VCR_GETDEVCAPS_CAN_DETECT_LENGTH

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät in der Lage ist, die Länge des Mediums zu erkennen. Andernfalls ist er auf FALSE festgelegt.

MCI_VCR_GETDEVCAPS_CAN_FREEZE

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

MCI_VCR_GETDEVCAPS_CAN_MONITOR_SOURCES

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

MCI_VCR_GETDEVCAPS_CAN_PREROLL

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät in der Lage ist, eine Vorabrollung durchzuführen. Andernfalls ist er auf FALSE festgelegt.

MCI_VCR_GETDEVCAPS_CAN_PREVIEW

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät vorschaufähig ist. Andernfalls ist er auf FALSE festgelegt.

MCI_VCR_GETDEVCAPS_CAN_REVERSE

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

MCI_VCR_GETDEVCAPS_CAN_TEST

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät zum Testen in der Lage ist; Andernfalls ist er auf FALSE festgelegt.

MCI_VCR_GETDEVCAPS_HAS_CLOCK

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät eine externe Uhr unterstützt. Andernfalls ist er auf FALSE festgelegt.

MCI_VCR_GETDEVCAPS_HAS_TIMECODE

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät über timecode-Funktionen verfügt oder wenn diese Funktion unbekannt ist. Andernfalls ist er auf FALSE festgelegt.

MCI_VCR_GETDEVCAPS_NUMBER_OF_MARKS

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

MCI_VCR_GETDEVCAPS_SEEK_ACCURACY

Der dwReturn-Member ist auf die Suchgenauigkeit des Geräts festgelegt.

Die folgenden Flags können im dwItem-Member von MCI_GETDEVCAPS_PARMS für den Überlagerungsgerätetyp angegeben werden:

MCI_OVLY_GETDEVCAPS_CAN_FREEZE

Das dwReturn-Element ist auf TRUE festgelegt, wenn das Gerät das Bild einfrieren kann. Andernfalls ist er auf FALSE festgelegt.

MCI_OVLY_GETDEVCAPS_CAN_STRETCH

Der dwReturn-Member ist auf TRUE festgelegt, wenn das Gerät das Bild strecken kann, um den Frame zu füllen. Andernfalls ist er auf FALSE festgelegt.

MCI_OVLY_GETDEVCAPS_MAX_WINDOWS

Der dwReturn-Member ist 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 videodisc-Gerätetyp angegeben werden:

MCI_VD_GETDEVCAPS_CAN_REVERSE

Der dwReturn-Member ist auf TRUE festgelegt, wenn der Videodisc-Player umgekehrt wiedergegeben werden kann. Andernfalls ist er auf FALSE festgelegt. Einige Spieler können CLV-Discs in reversen und CAV-Discs wiedergeben.

MCI_VD_GETDEVCAPS_CAV

Gibt bei 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 bei Kombination mit anderen Elementen an, dass die Rückgabeinformationen für Videodiscs im CLV-Format gelten.

MCI_VD_GETDEVCAPS_FAST_RATE

Das dwReturn-Element ist auf die schnelle Standardwiedergaberate in Frames pro Sekunde festgelegt.

MCI_VD_GETDEVCAPS_NORMAL_RATE

Das dwReturn-Element ist auf die normale Wiedergaberate in Frames pro Sekunde festgelegt.

MCI_VD_GETDEVCAPS_SLOW_RATE

Das dwReturn-Element ist 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

Der dwReturn-Member ist auf die Gesamtanzahl der Wellenformeingabegeräte (Aufzeichnungsgeräte) festgelegt.

MCI_WAVE_GETDEVCAPS_OUTPUT

Der dwReturn-Member ist auf die Gesamtanzahl der Waveform-Ausgabegerä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 (einschließlich Windows.h)

Siehe auch

MCI

MCI-Befehle