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 |
|