Capability-Befehl

  • Artikel

Der Funktionsbefehl fordert Informationen zu einer bestimmten Funktion eines Geräts an. Dieser Befehl wird von allen MCI-Geräten erkannt.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand wie folgt festgelegt ist.

_stprintf_s(
  lpszCommand, 
  TEXT("capability %s %s %s"), 
  lpszDeviceID, 
  lpszRequest, 
  lpszFlags
);

Parameter

lpszDeviceID

Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.

lpszRequest

Flag, das eine Gerätefunktion identifiziert. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Funktionsbefehl und die von den einzelnen Typen verwendeten Flags erkennen:

Wert type Typ
cdaudio
  • kann ausgeworfen werden
  • kann wiedergegeben werden.
  • kann aufzeichnen
  • kann speichern
  • Verbundgerät
  • Gerätetyp
  • verfügt über Audio
  • hat Video
  • verwendet Dateien
digitalvideo
  • kann ausgeworfen werden
  • kann einfrieren
  • kann sperren
  • kann wiedergegeben werden.
  • kann aufzeichnen
  • kann umgekehrt werden.
  • kann speichern
  • kann gestreckt werden
  • kann eingaben gestreckt werden
  • kann testen
  • Verbundgerät
  • Gerätetyp
  • verfügt über Audio
  • hat noch
  • hat Video
  • maximale Wiedergaberate
  • Minimale Wiedergaberate
  • verwendet Dateien
  • verwendet Paletten
  • Windows
overlay
  • kann ausgeworfen werden
  • kann einfrieren
  • kann wiedergegeben werden.
  • kann aufzeichnen
  • kann speichern
  • kann gestreckt werden
  • Verbundgerät
  • Gerätetyp
  • verfügt über Audio
  • hat Video
  • verwendet Dateien
  • Windows
sequencer
  • kann ausgeworfen werden
  • kann wiedergegeben werden.
  • kann aufzeichnen
  • kann speichern
  • Verbundgerät
  • Gerätetyp
  • verfügt über Audio
  • hat Video
  • verwendet Dateien
Vcr
  • kann die Länge erkennen
  • kann ausgeworfen werden
  • kann einfrieren
  • kann Quellen überwachen
  • kann wiedergegeben werden.
  • kann vorab registriert werden.
  • kann in der Vorschau angezeigt werden
  • kann aufzeichnen
  • kann umgekehrt werden.
  • kann speichern
  • kann testen
  • Takt inkrementierungsrate
  • Verbundgerät
  • Gerätetyp
  • verfügt über Audio
  • hat Uhr
  • verfügt über Einen Timecode.
  • hat Video
  • Anzahl von Markierungen
  • Suchgenauigkeit
  • verwendet Dateien
videodisc
  • kann ausgeworfen werden
  • kann wiedergegeben werden.
  • kann aufzeichnen
  • kann umgekehrt werden.
  • kann speichern
  • CAV
  • CLV
  • Verbundgerät
  • Gerätetyp
  • schnelle Wiedergaberate
  • verfügt über Audio
  • hat Video
  • normale Wiedergaberate
  • langsame Wiedergaberate
  • verwendet Dateien
Waveaudio
  • kann ausgeworfen werden
  • kann wiedergegeben werden.
  • kann aufzeichnen
  • kann speichern
  • Verbundgerät
  • Gerätetyp
  • verfügt über Audio
  • hat Video
  • inputs
  • outputs
  • verwendet Dateien

In der folgenden Tabelle sind die Flags aufgeführt, die im lpszRequest-Parameter angegeben werden können, und deren Bedeutung:

Flags Bedeutung
kann die Länge erkennen Gibt TRUE zurück, wenn das Gerät die Länge der Medien erkennen kann.
kann ausgeworfen werden Gibt TRUE zurück, wenn das Gerät die Medien auswerfen kann.
kann einfrieren Gibt TRUE zurück, wenn das Gerät Daten im Framepuffer fixieren kann.
kann sperren Gibt TRUE zurück, wenn das Gerät Daten sperren kann.
kann Quellen überwachen Gibt TRUE zurück, wenn das Gerät eine Eingabe (Quelle) unabhängig von der aktuellen Eingabeauswahl an die überwachte Ausgabe übergeben kann.
kann wiedergegeben werden. Gibt TRUE zurück, wenn das Gerät wiedergegeben werden kann.
kann vorab registriert werden. Gibt TRUE zurück, wenn das Gerät das Flag "preroll" mit dem Cue-Befehl unterstützt.
kann in der Vorschau angezeigt werden Gibt TRUE zurück, wenn das Gerät Vorschauversionen unterstützt.
kann aufzeichnen Gibt TRUE zurück, wenn das Gerät die Aufzeichnung unterstützt.
kann umgekehrt werden. Gibt TRUE zurück, wenn das Gerät umgekehrt wiedergegeben werden kann.
kann speichern Gibt TRUE zurück, wenn das Gerät Daten speichern kann.
kann gestreckt werden Gibt TRUE zurück, wenn das Gerät Rahmen strecken kann, um ein bestimmtes Anzeigerechteck auszufüllen.
kann eingaben gestreckt werden Gibt TRUE zurück, wenn das Gerät die Größe eines Bilds beim Digitalisieren im Framepuffer ändern kann.
kann testen Gibt TRUE zurück, wenn das Gerät die Test-Schlüsselwort (keyword) erkennt.
Cav In Kombination mit anderen Elementen gibt dieses Flag an, dass die Rückgabeinformationen für Videodiscs im CAV-Format gelten. Dies ist die Standardeinstellung, wenn keine videoDisc eingefügt wird.
Takt inkrementierungsrate Gibt die Anzahl der Unterteilungen zurück, die die externe Uhr pro Sekunde unterstützt. Wenn die externe Uhr eine Millisekundenuhr ist, ist der Rückgabewert 1000. Wenn der Rückgabewert 0 ist, wird keine Uhr unterstützt.
clv In Kombination mit anderen Elementen gibt dieses Flag an, dass die Rückgabeinformationen für Videodiscs im CLV-Format gelten.
Verbundgerät Gibt TRUE zurück, wenn das Gerät einen Elementnamen (Dateiname) unterstützt.
Gerätetyp Gibt einen Gerätetypnamen zurück, der wie folgt aussehen kann:
  • cdaudio
  • dat
  • digitalvideo
  • Andere
  • overlay
  • Scanner
  • sequencer
  • Vcr
  • videodisc
  • Waveaudio
schnelle Wiedergaberate Gibt die schnelle Wiedergaberate in Bildern pro Sekunde oder null zurück, wenn das Gerät nicht schnell wiedergegeben werden kann.
verfügt über Audio Gibt TRUE zurück, wenn das Gerät die Audiowiedergabe unterstützt.
hat Uhr Gibt TRUE zurück, wenn das Gerät über eine Uhr verfügt.
hat noch Gibt TRUE zurück, wenn das Gerät Dateien mit einem einzelnen Bild effizienter behandelt als Bewegungsvideodateien.
verfügt über Einen Timecode. Gibt TRUE zurück, wenn das Gerät Timecode unterstützen kann oder unbekannt ist.
hat Video Gibt TRUE zurück, wenn das Gerät Video unterstützt.
inputs Gibt die Gesamtzahl der Eingabegeräte zurück.
maximale Wiedergaberate Gibt die maximale Wiedergaberate in Frames pro Sekunde für das Gerät zurück.
Minimale Wiedergaberate Gibt die minimale Wiedergaberate in Frames pro Sekunde für das Gerät zurück.
normale Wiedergaberate Gibt die normale Wiedergaberate in Frames pro Sekunde für das Gerät zurück.
Anzahl von Markierungen Gibt die maximale Anzahl von Markierungen zurück, die verwendet werden können. null gibt an, dass Markierungen nicht unterstützt werden.
outputs Gibt die Gesamtzahl der Ausgabegeräte zurück.
Genauigkeit suchen Gibt die erwartete Genauigkeit einer Suche in Frames zurück. 0 gibt an, dass das Gerät framegenau ist, 1 gibt an, dass sich das Gerät innerhalb eines Rahmens der angegebenen Suchposition befindet usw.
langsame Wiedergaberate Gibt die langsame Wiedergaberate in Frames pro Sekunde oder 0 zurück, wenn das Gerät nicht langsam wiedergegeben werden kann.
verwendet Dateien Gibt TRUE zurück, wenn der von einem zusammengesetzten Gerät verwendete Datenspeicher eine Datei ist.
verwendet Paletten Gibt TRUE zurück, wenn das Gerät Paletten verwendet.
Windows Gibt die Anzahl gleichzeitiger Anzeigefenster zurück, die das Gerät unterstützen kann.

lpszFlags

Kann "warten", "benachrichtigen" oder beides sein. Für Digitalvideo- und Videorekordergeräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt Informationen im lpszReturnString-Parameter der mciSendString-Funktion zurück. Die Informationen sind vom Anforderungstyp abhängig.

Beispiele

Der folgende Befehl gibt den Gerätetyp des "mysound"-Geräts zurück.

capability mysound device type

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows 2000 Server [nur Desktop-Apps]

Siehe auch

MCI

MCI-Befehlszeichenfolgen

Hinweis