befehl MCI_INFO

Der Befehl MCI_INFO ruft Zeichenfolgeninformationen von einem Gerät ab. Alle Geräte erkennen diesen Befehl. Informationen werden im lpstrReturn-Element der durch lpInfo identifizierten Struktur zurückgegeben. Der dwRetSize-Member gibt die Pufferlänge für die zurückgegebenen Daten an.

Um diesen Befehl zu senden, rufen Sie die mciSendCommand-Funktion mit den folgenden Parametern auf.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_INFO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_INFO_PARMS) lpInfo
);

Parameter

wDeviceID

Geräte-ID des MCI-Geräts, das die Befehlsnachricht empfangen soll.

dwFlags

MCI_NOTIFY, MCI_WAIT oder MCI_TEST für digitale Video- und Videorekordergeräte. 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 null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Bemerkungen

Das folgende zusätzliche Standard- und befehlsspezifische Flag gilt für alle Geräte, die MCI_INFO unterstützen:

MCI_INFO_PRODUCT

Ruft eine Beschreibung der Einem Gerät zugeordneten Hardware ab. 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 in den abgefragten Player geladen wird. Dieses Flag gibt eine Zeichenfolge mit 16 Hexadezimalstellen zurück.

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

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 Digital-Video-Gerä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 Komprimierungsalgorithmus für Standbilder zurück.

MCI_DGV_INFO_STILL_QUALITY

Gibt den Namen für den aktuellen Qualitätsdeskriptor für das Standbild zurück.

MCI_DGV_INFO_USAGE

Gibt eine Zeichenfolge zurück, die Nutzungseinschränkungen beschreibt, die vom Besitzer des Visuals oder der hörbaren Daten im Arbeitsbereich auferlegt 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_INFO_VERSION

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 das Fenster Untertitel ab.

MCI_INFO_FILE

Ruft den Pfad und Dateinamen der letzten Datei ab, die mit dem Befehl MCI_OPEN oder MCI_LOAD angegeben wurde. Wenn keine Datei angegeben wurde, gibt das Gerät eine 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.

Bei Digital-Video-Geräten verweist lpInfo auf eine MCI_DGV_INFO_PARMS-Struktur .

Die folgenden zusätzlichen Flags gelten für den Sequencer-Gerätetyp :

MCI_INFO_COPYRIGHT

Ruft den MIDI-Datei-Copyright-Hinweis vom Copyright-Metaereignis ab.

MCI_INFO_FILE

Ruft den Dateinamen der aktuellen Datei ab. Dieses Flag wird nur von Geräten unterstützt, die TRUE zurückgeben, wenn Sie den Befehl MCI_GETDEVCAPS mit dem flag MCI_GETDEVCAPS_USES_FILES aufrufen.

MCI_INFO_NAME

Ruft den Sequenznamen aus dem Sequenz-/Spurnamen-Metaereignis ab.

Das folgende zusätzliche Flag gilt für den Vcr-Gerätetyp :

MCI_VCR_INFO_VERSION

Legt fest , dass der lpstrReturn-Member der MCI_INFO_PARMS-Struktur auf die Versionsnummer verweist. Legt außerdem den dwRetSize-Member auf die Länge der Zeichenfolge fest, auf die verwiesen wird.

Die folgenden zusätzlichen Flags gelten für den Überlagerungsgerätetyp :

MCI_INFO_FILE

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 Untertitel des Fensters ab, das dem Videoüberlagerungsgerät zugeordnet ist.

Die folgenden zusätzlichen Flags gelten für den Waveaudio-Gerätetyp :

MCI_INFO_FILE

Ruft den Dateinamen der aktuellen Datei ab. Dieses Flag wird von Geräten unterstützt, die TRUE zurückgeben, wenn Sie den Befehl MCI_GETDEVCAPS mit dem flag MCI_GETDEVCAPS_USES_FILES aufrufen.

MCI_WAVE_INPUT

Ruft den Produktnamen der aktuellen Eingabe ab.

MCI_WAVE_OUTPUT

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 (windows.h einschließen)

Siehe auch

MCI

MCI-Befehle