Share via


Abrufen eines Geräteschnittstellennamens

In Windows Me und Windows 2000 und höher können die Windows-Multimediafunktionen waveInMessage, waveOutMessage, midiInMessage, midiOutMessage und mixerMessage den Geräteschnittstellennamen eines Geräts abrufen. Diese Informationen sind nützlich für Anwendungsprogramme, die das Gerät außerhalb der waveIn-, waveOut-, midiIn-, midiOut- oder Mixer-API identifizieren müssen. Innerhalb einer dieser APIs ist eine Geräte-ID ausreichend.

Der Plug & Play-Manager generiert einen Geräteschnittstellennamen, um jedes Gerät eindeutig zu identifizieren, das er aufzählt. Eine Anwendung sollte die Zeichenfolge, die einen Geräteschnittstellennamen enthält, als undurchsichtig behandeln. Weitere Informationen zu Geräteschnittstellen finden Sie unter Einführung in Geräteschnittstellen.

Die Headerdatei Mmddk.h definiert zwei Nachrichtenkonstanten zum Abrufen von Geräteschnittstellennamen:

DRV_QUERYDEVICEINTERFACESIZE

DRV_QUERYDEVICEINTERFACE

Die erste Nachricht erhält die Größe des Puffers in Bytes, die erforderlich ist, um die Zeichenfolge mit dem Namen der Geräteschnittstelle zu enthalten. Die zweite Nachricht ruft die Namenszeichenfolge in einem Puffer der erforderlichen Größe ab.

Das System fängt die DRV_QUERYDEVICEINTERFACESIZE und DRV_QUERYDEVICEINTERFACE Nachrichten ab und verarbeitet sie, ohne die Nachrichten an den Gerätetreiber zu senden.

Der erste Parameter für die xxxMessage-Funktion ist die Geräte-ID, die der Aufrufer in den entsprechenden Handle-Typ umwandeln muss: HWAVEIN, HWAVEOUT, HMIDIIN, HMIDIOUT oder HMIXER. Weitere Informationen zu den xxx-Nachrichtenfunktionen finden Sie unter System-Intercepted Device Messages.For more information about the xxxMessage functions, see System-Intercepted Device Messages.