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
Mmsystem.h (include Windows.h)

Siehe auch

MCI

MCI-Befehle