Info-Befehl
Der Befehl info ruft eine Hardwarebeschreibung von einem Gerät ab. Dieser Befehl wird von allen MCI-Geräten erkannt.
Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der lpszCommand-Parameter wie folgt festgelegt ist.
_stprintf_s(
lpszCommand,
TEXT("info %s %s %s"),
lpszDeviceID,
lpszInfoType,
lpszFlags
);
Parameter
-
lpszDeviceID
-
Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.
-
lpszInfoType
-
Flag, das den Typ der erforderlichen Informationen angibt. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Infobefehl und die von den einzelnen Typen verwendeten Flags erkennen.
Wert Bedeutung Bedeutung cdaudio info identityinfo upc product digitalvideo audio algorithmaudio qualityfileproductöß algorithm quality usageversionvideo algorithmvideo qualitywindow text overlay fileproduct Fenstertext sequencer Copyrightdatei nameproduct Vcr product version videodisk product Waveaudio fileinput outputproduct Die folgende Tabelle enthält die Flags, die im lpszInfoType-Parameter angegeben werden können, und ihre Bedeutungen.
Wert Bedeutung Audioalgorithmus Gibt den Namen des aktuellen Audiokomprimierungsalgorithmus zurück. Audioqualität Gibt den Namen für den aktuellen Audioqualitätsdeskriptor zurück. Dies kann "unbekannt" zurückgeben, wenn die Anwendung Parameter auf bestimmte Werte festgelegt hat, die nicht definierten Qualitäten entsprechen. Copyright Ruft den COPYRIGHT-Hinweis für die DATEI COPYRIGHT aus dem Copyrightmetaereignis ab. file Ruft den Namen der Datei ab, die vom Verbundgerät verwendet wird. Wenn das Gerät ohne Datei geöffnet wird und der Ladebefehl nicht verwendet wurde, wird eine NULL-Zeichenfolge zurückgegeben. Infoidentität Erzeugt einen eindeutigen Bezeichner für die Audio-CD, die derzeit in den abgefragten Player geladen ist. info upc Erzeugt den Universal Product Code (UPC), der auf einer Audio-CD codiert ist. Der UPC ist eine Zeichenfolge von Ziffern. Sie ist möglicherweise nicht für alle CDs verfügbar. input Ruft die Beschreibung des aktuellen Eingabegeräts ab. Gibt "none" zurück, wenn ein Eingabegerät nicht festgelegt ist. name Ruft den Sequenznamen aus dem Sequenz-/Nachverfolgungsnamen-Metaereignis ab. output Ruft die Beschreibung des aktuellen Ausgabegeräts ab. Gibt "none" zurück, wenn ein Ausgabegerät nicht festgelegt ist. product Ruft eine Beschreibung des Geräts ab. Diese Informationen enthalten häufig den Produktnamen und das Modell. Die Zeichenfolgenlänge beträgt 31 Zeichen oder weniger. still-Algorithmus Gibt den Namen des aktuellen Algorithmus für die Komprimierung von Standbildern zurück. Stille Qualität Gibt den Namen für den aktuellen Imagequalitätsdeskriptor zurück. Dies kann "unbekannt" zurückgeben, wenn die Anwendung Parameter auf bestimmte Werte festgelegt hat, die nicht definierten Qualitäten entsprechen. Nutzung Gibt eine Zeichenfolge zurück, die Nutzungseinschränkungen beschreibt, die möglicherweise vom Besitzer der Visuellen Oder Audiodaten im Arbeitsbereich erzwungen werden. version Gibt die Releaseebene des Gerätetreibers und der Hardware zurück. Videoalgorithmus Gibt den Namen des aktuellen Algorithmus für die Videokomprimierung zurück. Videoqualität Gibt den Namen für den aktuellen Videoqualitätsdeskriptor zurück. Dies kann "unbekannt" zurückgeben, wenn die Anwendung Parameter auf bestimmte Werte festgelegt hat, die nicht definierten Qualitäten entsprechen. Fenstertext Ruft die Beschriftung des vom Gerät verwendeten Fensters ab. -
lpszFlags
-
Kann "wait", "notify" oder beides sein. Für DigitalVideo- und VCR-Geräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.
Rückgabewert
Gibt 0 (null) zurück, wenn der Fehler erfolgreich war, oder andernfalls ein Fehler.
Beispiele
Der folgende Befehl ruft eine Beschreibung der Hardware ab, die dem Gerät "mysound" zugeordnet ist.
info mysound product
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |