Freigeben über


MCI_LIST Befehl

Der Befehl „MCI_LIST“ ruft Informationen über die Anzahl und Eingabetypen ab, die für das Gerät verfügbar sind. 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 empfängt.

dwFlags

MCI_NOTIFY, MCI_WAIT oder MCI_TEST. Informationen zu diesen Flags finden Sie unter „Wait“, „Notify“ und „Test Flags“.

lpList

Zeiger auf eine MCI_GENERIC_PARMS Struktur. (Geräte mit erweiterten Befehlssätzen können diese Struktur durch eine gerätespezifische Struktur ersetzen.)

Rückgabewert

Gibt Null zurück, wenn dies erfolgreich ist oder andernfalls ein Fehler auftritt.

Hinweise

Die folgenden zusätzlichen Flags gelten für den Digitalvideo-Gerätetyp:

MCI_DGV_LIST_ALG

Das lpstrAlgorithm-Element der durch 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 angibt, dass der Listentyp im dwItem-Element der Struktur enthalten ist, die durch lpList identifiziert wird. 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 das lpstrAlgorithm-Element der Struktur verweist, die durch lpList identifiziert wird. Wenn dieses Element mithilfe 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 Audiodatenströmen abrufen.

MCI_DGV_LIST_STILL_AL

Der Befehl sollte Namen von Stillalgorithmen abrufen.

MCI_DGV_LIST_STILL_QUALITY

Der Befehl sollte Qualitätsstufen abrufen. Die zurückgegebenen Ebenen sind dem Algorithmus zugeordnet, auf den das lpstrAlgorithm-Element der Struktur verweist, die durch lpList identifiziert wird. Wenn dieses Element mithilfe 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 Audioalgorithmen abrufen.

MCI_DGV_LIST_VIDEO_QUALITY

Der Befehl sollte Videoqualitätsstufen abrufen. Die zurückgegebenen Ebenen sind dem Algorithmus zugeordnet, auf den das lpstrAlgorithm-Element der Struktur verweist, die durch lpList identifiziert wird. Wenn dieses Element mithilfe 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 mehr als eine Quelle jedes Typs geben, der zurückgegeben wird. Der generische Quelltyp wird verwendet, wenn für diesen Connector mehrere Signaltypen zulässig sind.

MCI_DGV_LIST_VIDEO_STREAM

Der Befehl sollte Namen von Videodatenströmen abrufen.

MCI_DGV_LIST_NUMBER

Ein Index wird im dwNumber-Element der Struktur angegeben, die durch lpList identifiziert wird. Der Index muss eine ganze Zahl zwischen 1 und dem Wert sein, der für die MCI_DGV_LIST_COUNT-Flag zurückgegeben wird.

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.

MCI_VCR_LIST_COUNT

Legt das dwReturn-Element der Struktur fest, das durch lpList identifiziert wird, auf die Gesamtanzahl der Video- oder Audioeingaben.

MCI_VCR_LIST_NUMBER

Legt das dwReturn-Element der Struktur fest, das durch lpList identifiziert wird, auf den Typ der Video- oder Audioeingabe, die vom dwNumber-Element angegeben wird.

MCI_VCR_LIST_VIDEO_SOURCE

Auflisten von Videoeingaben oder -typen.

Bei VCR-Geräten 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 (einschließlich Windows.h)

Siehe auch

MCI

MCI-Befehle