MCI _ INFO-Befehl
Der _ MCI INFO-Befehl ruft Zeichenfolgeninformationen von einem Gerät ab. Dieser Befehl wird von allen Geräten erkannt. Informationen werden im lpstrReturn-Member der durch lpInfo identifizierten Struktur zurückgegeben. Der dwRetSize-Member gibt die Pufferlänge für die zurückgegebenen Daten an.
Rufen Sie zum Senden dieses Befehls die mciSendCommand-Funktion mit den folgenden Parametern auf.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_INFO,
DWORD dwFlags,
(DWORD) (LPMCI_INFO_PARMS) lpInfo
);
Parameter
-
wDeviceID
-
Gerätebezeichner des MCI-Geräts, das die Befehlsmeldung empfangen soll.
-
Dwflags
-
MCI _ NOTIFY, MCI _ WAIT oder, für Digital Video- und VCR-Geräte, MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.
-
lpInfo
-
Zeiger auf eine MCI _ INFO _ 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
Das folgende zusätzliche Standard- und Befehlsflag gilt für alle Geräte, die MCI _ INFO unterstützen:
-
MCI _ INFO _ PRODUCT
-
Ruft eine Beschreibung der Hardware ab, die einem Gerät zugeordnet ist. Geräte sollten eine Beschreibung bereitstellen, die sowohl den Treiber als auch die verwendete Hardware identifiziert.
Die folgenden zusätzlichen Flags gelten für den Cdaudio-Gerätetyp:
-
MCI _ INFO _ MEDIA _ IDENTITY
-
Erzeugt einen eindeutigen Bezeichner für die Audio-CD, die derzeit im abgefragten Player geladen ist. Dieses Flag gibt eine Zeichenfolge mit 16 Hexadezimalziffern zurück.
-
MCI _ INFO _ MEDIA _ 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.
Die folgenden zusätzlichen Flags gelten für den Digitalvideo-Gerätetyp:
-
MCI _ DGV _ INFO _ ITEM
-
Eine Konstante, die die gewünschten Informationen angibt, ist im dwItem-Member der durch lpInfo identifizierten Struktur enthalten. Die folgenden Konstanten werden für Digitalvideogeräte definiert:
-
MCI _ DGV _ INFO _ AUDIO _ ALG
-
Gibt den Namen für den aktuellen Audiokomprimierungsalgorithmus zurück.
-
MCI _ DGV _ INFO _ AUDIO _ QUALITY
-
Gibt den Namen für den aktuellen Audioqualitätsdeskriptor zurück.
-
MCI _ DGV _ INFO _ STILL _ ALG
-
Gibt den Namen für den aktuellen Algorithmus für die Komprimierung von Standbildern zurück.
-
MCI _ DGV _ INFO _ STILL _ QUALITY
-
Gibt den Namen für den aktuellen Imagequalitätsdeskriptor zurück.
-
VERWENDUNG _ VON MCI-DGV-INFORMATIONEN _ _
-
Gibt eine Zeichenfolge zurück, die Nutzungseinschränkungen beschreibt, die vom Besitzer der visuellen oder akustischen Daten im Arbeitsbereich erzwungen werden können.
-
MCI _ DGV _ INFO _ VIDEO _ ALG
-
Gibt den Namen für den aktuellen Videokomprimierungsalgorithmus zurück.
-
MCI _ DGV _ INFO _ VIDEO _ QUALITY
-
Gibt den Namen für den aktuellen Videoqualitätsdeskriptor zurück.
-
_MCI-INFOVERSION _
-
Gibt die Releaseebene des Gerätetreibers und der Hardware zurück. Gerätetreiberentwickler müssen die Syntax der zurückgegebenen Zeichenfolge dokumentieren.
-
MCI _ DGV _ INFO _ TEXT
-
Ruft die Fensterbeschriftung ab.
-
_MCI-INFODATEI _
-
Ruft den Pfad und den Dateinamen der letzten Datei ab, die mit dem MCI _ OPEN- oder MCI _ LOAD-Befehl angegeben wurde. Wenn keine Datei angegeben wurde, gibt das Gerät eine auf NULL endende Zeichenfolge zurück. Dieses Flag wird nur von Geräten unterstützt, die TRUE an das MCI _ GETDEVCAPS _ USES _ FILES-Flag des MCI _ GETDEVCAPS-Befehls zurückgeben.
Für Digitalvideogeräte verweist lpInfo auf eine MCI _ DGV _ INFO _ PARMS-Struktur.
Die folgenden zusätzlichen Flags gelten für den Sequencergerätetyp:
-
MCI _ INFO _ COPYRIGHT
-
Ruft den COPYRIGHT-Hinweis für die DATEI COPYRIGHT aus dem Copyrightmetaereignis ab.
-
_MCI-INFODATEI _
-
Ruft den Dateinamen der aktuellen Datei ab. Dieses Flag wird nur von Geräten unterstützt, die TRUE zurückgeben, wenn Sie den MCI _ GETDEVCAPS-Befehl mit dem _ MCI GETDEVCAPS _ USES _ FILES-Flag aufrufen.
-
_MCI-INFONAME _
-
Ruft den Sequenznamen aus dem Sequenz-/Nachverfolgungsnamen-Metaereignis ab.
Das folgende zusätzliche Flag gilt für den Vcr-Gerätetyp:
-
MCI _ VCR _ INFO _ VERSION
-
Legt den lpstrReturn-Member der MCI INFO _ _ PARMS-Struktur so fest, dass er auf die Versionsnummer verweist. Legt außerdem das dwRetSize-Element auf die Länge der Zeichenfolge fest, auf die gezeigt wird.
Die folgenden zusätzlichen Flags gelten für den Überlagerungsgerätetyp:
-
_MCI-INFODATEI _
-
Ruft den Dateinamen der aktuellen Datei ab. Dieses Flag wird nur von Geräten unterstützt, die TRUE an das MCI _ GETDEVCAPS _ USES _ FILES-Flag des MCI _ GETDEVCAPS-Befehls zurückgeben.
-
MCI _ OVLY _ INFO _ TEXT
-
Ruft die Beschriftung des Fensters ab, das dem Videoüberlagerungsgerät zugeordnet ist.
Die folgenden zusätzlichen Flags gelten für den Waveaudio-Gerätetyp:
-
_MCI-INFODATEI _
-
Ruft den Dateinamen der aktuellen Datei ab. Dieses Flag wird von Geräten unterstützt, die TRUE zurückgeben, wenn Sie den MCI _ GETDEVCAPS-Befehl mit dem _ MCI GETDEVCAPS _ USES _ FILES-Flag aufrufen.
-
MCI _ WAVE _ INPUT
-
Ruft den Produktnamen der aktuellen Eingabe ab.
-
MCI _ _ WAVE-AUSGABE
-
Ruft den Produktnamen der aktuellen Ausgabe ab, und sein Wert ist gerätespezifisch.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|