Zugreifen auf die bevorzugte Geräte-ID

Die Windows-Multimediafunktionen waveInMessage, waveOutMessage und midiOutMessage können die Geräte-ID des bevorzugten Geräts abrufen. Diese drei Funktionen erhalten die bevorzugten Geräte-IDs für Welleneingabe, Wellenausgang und MIDI-Ausgabe. Diese Informationen sind nützlich für Anwendungsprogramme, mit denen Benutzer beispielsweise ein Zu öffnende Gerät aus einer Liste von zwei oder mehr Geräten auswählen können. Eine solche Anwendung muss in der Regel angeben, welches der Geräte in der Liste das bevorzugte Gerät ist.

Das bevorzugte Gerät ist das Gerät, das der Benutzer über die Multimedia-Systemsteuerung auswählt, mmsys.cpl. Wenn eine Windows-Multimedia- oder DirectSound-Anwendung nicht explizit ein Gerät angibt, wird standardmäßig das bevorzugte Gerät ausgewählt.

Um die Geräte-ID des aktuellen bevorzugten Audiogeräts abzurufen, ruft eine Anwendung die xxxMessage-Funktion auf, wobei der Nachrichtenparameter auf die Konstante DRVM_MAPPER_PREFERRED_GET festgelegt ist.

Wenn Sie die Funktion waveInMessage, waveOutMessage oder midiOutMessage mit der DRVM_MAPPER_PREFERRED_GET Nachricht aufrufen, geben Sie den Wert des Gerätehandles als WAVE_MAPPER (für waveInMessage oder waveOutMessage) oder MIDI_MAPPER (für midiOutMessage) an, und wandeln Sie diesen Wert in den entsprechenden Handle-Typ um: HWAVEIN, HWAVEOUT oder HMIDIOUT. Die xxx-Nachrichtenfunktionen akzeptieren diesen Wert anstelle eines gültigen Gerätehandles, sodass eine Anwendung die Standardgeräte-ID abfragen kann, ohne zuvor ein Gerät öffnen zu müssen. Weitere Informationen zu den xxx-Nachrichtenfunktionen finden Sie unter System-Intercepted Device Messages.For more information about the xxx Message functions, see System-Intercepted Device Messages.

Die DRVM_MAPPER_PREFERRED_GET Nachricht wird vom Mapper für das Zielgerät (waveIn, waveOut oder midiOut) abgefangen. Informationen zu Mappern für Wave- und MIDI-Geräte finden Sie in der Microsoft Windows SDK-Dokumentation.