Befehl „info“

Artikel
06/13/2023

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 parameter lpszCommand 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 Befehl info und die von jedem Typ verwendeten Flags erkennen.

Wert	Bedeutung	Bedeutung
cdaudio	info identityinfo upc	product
digitalvideo	Audioalgorithmusaudio qualityfileproductstill algorithmusStille Qualität	usageVersionVideo-AlgorithmusVideoqualitätWindow-Text
overlay	fileproduct	Fenstertext
sequencer	copyrightfile	nameproduct
Vcr	product	version
videodisk	product
Waveaudio	fileinput	outputproduct

In der folgenden Tabelle sind die Flags aufgeführt, die im lpszInfoType-Parameter angegeben werden können, und deren Bedeutung.

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 MIDI-Datei-Copyrighthinweis aus dem Copyright-Metaereignis 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.
Info-Identität	Erzeugt einen eindeutigen Bezeichner für die Audio-CD, die derzeit in den abgefragten Player geladen wird.
info upc	Erzeugt den universellen Produktcode (UPC), der auf einer Audio-CD codiert ist. Der UPC ist eine Zeichenfolge von Ziffern. Es 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-/Spurnamen-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 maximal 31 Zeichen.
still-Algorithmus	Gibt den Namen des aktuellen Stillbildkomprimierungsalgorithmus zurück.
noch Qualität	Gibt den Namen für den aktuellen Qualitätsdeskriptor für das Standbild 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 vom Besitzer der Visual- oder Audiodaten im Arbeitsbereich auferlegt werden können.
version	Gibt die Releaseebene des Gerätetreibers und der Hardware zurück.
Videoalgorithmus	Gibt den Namen des aktuellen Videokomprimierungsalgorithmus 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 Untertitel des fensters ab, das vom Gerät verwendet wird.

lpszFlags

Kann "warte", "benachrichtigen" oder beides sein. Für Digital-Video- 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 null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

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]

Siehe auch

MCI
MCI-Befehlszeichenfolgen
Laden