Befehl „list“

Der List-Befehl bestimmt die Anzahl und die Typen von Video- und Audioeingaben. Digitalvideo- und Videorekordergeräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand 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 Typen von Video- und Audioeingaben angibt. 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-Algorithmusaudio-Qualitätsalgorithmus audio streamcountnumber index	stillalgorithmus Qualitätsalgorithmus Video-AlgorithmusVideoqualitätsalgorithmus-AlgorithmusVideoquelleVideostream
Vcr	Audioquelle countaudio Quellnummernindex	Anzahl der VideoquellenVideo-Quellnummernindex

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

Wert	Bedeutung
Audioalgorithmus	Gibt an, dass der Befehl Die Namen des Audioalgorithmus abrufen soll.
Algorithmus für audioqualitätsalgorithmus	Gibt an, dass der Befehl Qualitätsstufen abrufen soll, die dem angegebenen Algorithmus zugeordnet sind. Wenn der Algorithmus "aktuell" ist, wird die Qualitätsebene des aktuellen Algorithmus zurückgegeben.
Anzahl der Audioquellen	Gibt die Gesamtzahl der Audioeingaben zurück.
Index der Audioquellennummer	Gibt den Typ der Audioeingabe des Quellindex 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") werden 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 index identifiziert) des angegebenen Optionstyps beschreibt. 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.
still quality algorithm algorithm	Gibt an, dass der Befehl Qualitätsstufen abrufen soll, die dem angegebenen still-Algorithmus zugeordnet sind. Wenn der Algorithmus "aktuell" ist, wird die Qualitätsebene des aktuellen Algorithmus zurückgegeben.
Videoalgorithmus	Gibt an, dass der Befehl Die Namen des Videoalgorithmus abrufen soll.
Videoqualitätsalgorithmusalgorithmus	Gibt an, dass der Befehl Qualitätsstufen abrufen soll, die dem angegebenen Videoalgorithmus zugeordnet sind. Wenn der Algorithmus "aktuell" ist, wird die Qualitätsebene 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 "Zahl" 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 mehr als eine Quelle 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 Gesamtanzahl der Videoeingaben zurück.
Index der Videoquellnummer	Gibt den Typ der Videoeingabe des Quellindexes zurück.
Videostream	Gibt an, dass der Befehl die Namen der Videostreams abrufen soll, die dem Arbeitsbereich zugeordnet sind. Diese Zeichenfolgen (z. B. "lustiges Ende" oder "trauriges Ende") werden in die Datei eingebettet und identifizieren den Stream.

lpszFlags

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

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Bemerkungen

Für VcR-Geräte muss entweder "Videoquelle" oder "Audioquelle" mit dem Flag "count" oder "number" angegeben werden. Wenn "count" angegeben wird, wird die Gesamtanzahl der Eingänge von Video- oder Audiodaten zurückgegeben. Wenn "number" angegeben ist, 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 der "Anzahl" abfragen und dann die Anzahl als Bereich für das Flag "Zahl" verwenden. Die Quellnummern beginnen mit 1.

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