MCI _ LIST-Befehl
Der _ MCI LIST-Befehl ruft Informationen über die Anzahl und typen der eingaben ab, die dem Gerät zur Verfügung stehen. DigitalVideo- und VCR-Geräte erkennen diesen Befehl.
Rufen Sie zum Senden dieses Befehls die mciSendCommand-Funktion mit den folgenden Parametern auf.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_LIST,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpList
);
Parameter
-
wDeviceID
-
Gerätebezeichner des MCI-Geräts, das die Befehlsmeldung empfangen soll.
-
Dwflags
-
MCI _ NOTIFY, MCI _ WAIT oder MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.
-
lpList
-
Zeiger auf eine GENERISCHE _ MCI-PARMS-Struktur. _ (Geräte mit erweiterten Befehlssätzen können diese Struktur durch eine gerätespezifische Struktur ersetzen.)
Rückgabewert
Gibt 0 (null) zurück, wenn der Fehler erfolgreich war, oder andernfalls ein Fehler.
Bemerkungen
Die folgenden zusätzlichen Flags gelten für den Digitalvideo-Gerätetyp:
-
MCI _ DGV _ LIST _ ALG
-
Der lpstrAlgorithm-Member der von lpList identifizierten Struktur enthält eine Adresse eines Puffers, der den Namen eines Algorithmus enthält. Der Name wird verwendet, um die Typen von Qualitätsdeskriptoren abzurufen, die einem Algorithmus zugeordnet sind.
-
MCI _ DGV _ LIST _ COUNT
-
Gibt die Anzahl der Optionen des angegebenen Typs zurück.
-
MCI _ DGV _ LIST _ ITEM
-
Eine Konstante, die den Listentyp angibt, ist im dwItem-Member der durch lpList identifizierten Struktur enthalten. Dieses Flag ist erforderlich. Verwenden Sie eine der folgenden Konstanten, um den Listentyp anzugeben:
-
MCI _ DGV _ LIST _ AUDIO _ ALG
-
Der Befehl sollte Namen von Audioalgorithmen abrufen.
-
MCI _ DGV _ LIST _ AUDIO _ QUALITY
-
Der Befehl sollte Audioqualitätsstufen abrufen. Die zurückgegebenen Ebenen sind dem Algorithmus zugeordnet, auf den der lpstrAlgorithm-Member der von lpList identifizierten Struktur verweist. Wenn dieser Member mit der Zeichenfolge "current" angegeben wird, werden die dem aktuellen Algorithmus zugeordneten Qualitäten zurückgegeben.
-
MCI _ DGV _ LIST _ AUDIO _ STREAM
-
Der Befehl sollte Namen von Audiostreams abrufen.
-
MCI _ DGV _ LIST _ STILL _ AL
-
Der Befehl sollte Namen von still-Algorithmen abrufen.
-
MCI _ DGV _ LIST _ STILL _ QUALITY
-
Der Befehl sollte Qualitätsstufen abrufen. Die zurückgegebenen Ebenen sind dem Algorithmus zugeordnet, auf den der lpstrAlgorithm-Member der von lpList identifizierten Struktur verweist. Wenn dieser Member mit der Zeichenfolge "current" angegeben wird, werden die dem aktuellen Algorithmus zugeordneten Qualitäten zurückgegeben.
-
MCI _ DGV _ LIST _ VIDEO _ ALG
-
Der Befehl sollte Namen von Videoalgorithmen abrufen.
-
MCI _ DGV _ LIST _ VIDEO _ QUALITY
-
Der Befehl sollte Videoqualitätsstufen abrufen. Die zurückgegebenen Ebenen sind dem Algorithmus zugeordnet, auf den der lpstrAlgorithm-Member der von lpList identifizierten Struktur verweist. Wenn dieser Member mit der Zeichenfolge "current" angegeben wird, werden die dem aktuellen Algorithmus zugeordneten Qualitäten zurückgegeben.
-
MCI _ DGV _ LIST _ VIDEO _ SOURCE
-
Der Befehl sollte Informationen zu den Videoquellen zurückgeben. Bei Verwendung mit MCI _ DGV _ LIST COUNT gibt der Befehl die Anzahl der _ Videoquellen zurück. Bei Verwendung mit MCI _ DGV _ LIST NUMBER gibt der Befehl den Typ einer _ Videoquelle zurück. MCI definiert die folgenden Typen:
- MCI _ DGV _ SETVIDEO _ SRC _ GENERIC
- MCI _ DGV _ SETVIDEO _ SRC _ NTSC
- MCI _ DGV _ SETVIDEO _ SRC _ PAL
- MCI _ DGV _ SETVIDEO _ SRC _ RGB
- MCI _ DGV _ SETVIDEO _ SRC _ SECAM
- MCI _ DGV _ SETVIDEO _ SRC _ SVIDEO
Es kann mehrere Quellen für jeden zurückgegebenen Typ geben. Der generische Quelltyp wird verwendet, wenn mehr als ein Signaltyp für diesen Connector zulässig ist.
-
MCI _ DGV _ LIST _ VIDEO _ STREAM
-
Der Befehl sollte Namen von Videostreams abrufen.
-
MCI _ DGV _ LIST _ NUMBER
-
Ein Index wird im dwNumber-Member der durch lpList identifizierten Struktur angegeben. Der Index muss eine ganze Zahl zwischen 1 und dem für das MCI _ DGV _ LIST _ COUNT-Flag zurückgegebenen Wert sein.
Für Digitalvideogeräte verweist lpList auf eine MCI _ DGV _ LIST _ PARMS-Struktur.
Die folgenden zusätzlichen Flags gelten für den Vcr-Gerätetyp:
-
MCI _ VCR _ LIST _ AUDIO _ SOURCE
-
Auflisten von Audioeingaben oder -typen.
-
ANZAHL DER _ MCI-VCR-LISTEN _ _
-
Legt den dwReturn-Member der von lpList identifizierten Struktur auf die Gesamtzahl der Video- oder Audioeingaben fest.
-
MCI _ VCR _ LIST _ NUMBER
-
Legt den dwReturn-Member der von lpList identifizierten Struktur auf den Typ der Video- oder Audioeingabe fest, die vom dwNumber-Member angegeben wird.
-
MCI _ VCR _ LIST _ VIDEO _ SOURCE
-
Auflisten von Videoeingaben oder -typen.
Für VCR-Geräte verweist lpList auf eine MCI _ VCR _ LIST _ PARMS-Struktur.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|