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
Mmsystem.h (include Windows.h)

Siehe auch

MCI

MCI-Befehle