Befehl „list“

Der Befehl list bestimmt die Anzahl und die Typen von Video- und Audioeingaben. Digital-Video- und VCR-Geräte erkennen diesen Befehl.

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

_stprintf_s(
  lpszCommand, 
  TEXT("list %s %s %s"), 
  lpszDeviceID, 
  lpszList, 
  lpszFlags
); 

Parameter

lpszDeviceID

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

lpszList

Flag, das die Anzahl und die Typen von Video- und Audioeingaben identifiziert. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Listenbefehl und die von den einzelnen Typen verwendeten Flags erkennen.

Wert Bedeutung Bedeutung
digitalvideo audio algorithmaudio quality algorithm algorithm audio streamcountnumber index noch algorithmusqualität algorithmus algorithmus video algorithmvideo quality algorithm algorithm video sourcevideo stream
Vcr Zahlenindex der Audioquelleaudio source number VideoquellenanzahlVideo source number index

In der folgenden Tabelle sind die Flags, die im lpszList-Parameter angegeben werden können, und ihre Bedeutungen aufgeführt.

Wert Bedeutung
Audioalgorithmus Gibt an, dass der Befehl Audioalgorithmusnamen abrufen soll.
Algorithmus für Audioqualität Gibt an, dass der Befehl Qualitätsstufen abrufen soll, die dem angegebenen Algorithmus zugeordnet sind. Wenn der Algorithmus "current" ist, wird die Qualitätsstufe des aktuellen Algorithmus zurückgegeben.
Anzahl der Audioquellen Gibt die Gesamtzahl der Audioeingaben zurück.
Index der Audioquellennummer Gibt den Typ der Audioeingabe des Quellindexes zurück.
Audiostream Gibt an, dass der Befehl die Namen der Audiostreams abrufen soll, die dem Arbeitsbereich zugeordnet sind. Diese Zeichenfolgen (z. B. "Englisch" oder "Deutsch") sind in die Datei eingebettet und identifizieren den Stream.
count Gibt die Anzahl der Optionen des angegebenen Typs zurück.
Zahlenindex Gibt eine Zeichenfolge zurück, die eine bestimmte Option (wie durch den Index identifiziert) des angegebenen Optionstyps beschreibt. Der Index muss eine ganze Zahl zwischen 1 und dem von "count" zurückgegebenen Wert sein.
still-Algorithmus Gibt an, dass der Befehl noch Algorithmusnamen abrufen soll.
Algorithmus für Noch-Qualität-Algorithmus Gibt an, dass der Befehl Qualitätsstufen abrufen soll, die dem angegebenen still-Algorithmus zugeordnet sind. Wenn der Algorithmus "current" ist, wird die Qualitätsstufe des aktuellen Algorithmus zurückgegeben.
Videoalgorithmus Gibt an, dass der Befehl Namen von Videoalgorithmen abrufen soll.
Algorithmus für Videoqualitätsalgorithmus Gibt an, dass der Befehl Qualitätsstufen abrufen soll, die dem angegebenen Videoalgorithmus zugeordnet sind. Wenn der Algorithmus "current" ist, wird die Qualitätsstufe des aktuellen Algorithmus zurückgegeben.
Videoquelle Gibt an, dass der Befehl Informationen zu den Videoquellen zurückgeben soll. Bei Verwendung mit dem Flag "count" wird die Anzahl der Videoquellen zurückgegeben. Bei Verwendung mit dem Flag "number" wird der Typ einer Videoquelle zurückgegeben. MCI definiert die folgenden Konstanten für den Typ: "ntsc", "rgb", "pal", "secam", "svideo" und "generic". Es kann mehrere Quellen für jeden zurückgegebenen Typ geben. Der "generische" Quelltyp wird verwendet, wenn für diesen Connector mehr als ein Signal zulässig ist.
Anzahl der Videoquellen Gibt die Gesamtzahl der Videoeingaben zurück.
Index der Videoquellennummer Gibt den Typ der Videoeingabe des Quellindexes zurück.
Videostream Gibt an, dass der Befehl die Namen von Videostreams abrufen soll, die dem Arbeitsbereich zugeordnet sind. Diese Zeichenfolgen (z. B. "endend" oder "sad ending") werden in die Datei eingebettet und identifizieren den Stream.

lpszFlags

Kann "wait", "notify" oder "test" sein. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

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

Bemerkungen

Für VCR-Geräte muss entweder "Videoquelle" oder "Audioquelle" mit den Flags "count" oder "number" angegeben werden. Wenn "count" angegeben wird, wird die Gesamtzahl der Eingaben von Videos oder Audiodaten zurückgegeben. Wenn "number" angegeben wird, gibt der Treiber einen Typ zurück, der der Eingabe entspricht. Der Typ kann einer der folgenden Sein: "tuner", "line", "svideo", "aux" oder "generic". In der Regel sollten Sie zuerst den VCR nach "count" abfragen und dann die Anzahl als Bereich für das Flag "number" verwenden. Die "Quell"-Zahlen beginnen bei 1.

Requirements (Anforderungen)

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

Weitere Informationen

MCI

MCI-Befehlszeichenfolgen