mixerGetControlDetails-Funktion (mmeapi.h)

Artikel
08/24/2023

Die MixerGetControlDetails-Funktion ruft Details zu einem einzelnen Steuerelement ab, das einer Audiozeile zugeordnet ist.

Syntax

MMRESULT mixerGetControlDetails(
  HMIXEROBJ             hmxobj,
  LPMIXERCONTROLDETAILS pmxcd,
  DWORD                 fdwDetails
);

Parameter

hmxobj

Handle für das abgefragte Mixergerätobjekt.

pmxcd

Zeiger auf eine MIXERCONTROLDETAILS-Struktur , die mit Zustandsinformationen zum Steuerelement gefüllt ist.

fdwDetails

Flags zum Abrufen von Steuerelementdetails. Die folgenden Werte werden definiert.

Wert	Bedeutung
MIXER_GETCONTROLDETAILSF_LISTTEXT	Das paDetails-Element der MIXERCONTROLDETAILS-Struktur verweist auf eine oder mehrere MIXERCONTROLDETAILS_LISTTEXT Strukturen, um Textbeschriftungen für Steuerelemente mit mehreren Elementen zu empfangen. Eine Anwendung muss alle Listentextelemente für ein Steuerelement mit mehreren Elementen gleichzeitig abrufen. Dieses Flag kann nicht mit MIXERCONTROL_CONTROLTYPE_CUSTOM-Steuerelementen verwendet werden.
MIXER_GETCONTROLDETAILSF_VALUE	Aktuelle Werte für ein Steuerelement werden abgerufen. Das paDetails-Element der MIXERCONTROLDETAILS-Struktur verweist auf eine oder mehrere Detailstrukturen, die für die Steuerelementklasse geeignet sind.
MIXER_OBJECTF_AUX	Der hmxobj-Parameter ist ein Hilfsgerätebezeichner im Bereich von null bis eins kleiner als die Anzahl der Geräte, die von der auxGetNumDevs-Funktion zurückgegeben werden.
MIXER_OBJECTF_HMIDIIN	Der hmxobj-Parameter ist das Handle eines MIDI-Eingabegeräts (Musical Instrument Digital Interface). Dieses Handle muss von der midiInOpen-Funktion zurückgegeben worden sein.
MIXER_OBJECTF_HMIDIOUT	Der hmxobj-Parameter ist das Handle eines MIDI-Ausgabegeräts. Dieses Handle muss von der midiOutOpen-Funktion zurückgegeben worden sein.
MIXER_OBJECTF_HMIXER	Der hmxobj-Parameter ist ein Mischer-Gerätehandle, das von der MixerOpen-Funktion zurückgegeben wird. Dieses Flag ist optional.
MIXER_OBJECTF_HWAVEIN	Der hmxobj-Parameter ist ein Waveform-Audio-Eingabehandle, das von der waveInOpen-Funktion zurückgegeben wird.
MIXER_OBJECTF_HWAVEOUT	Der hmxobj-Parameter ist ein Waveform-Audio-Ausgabehandle, das von der waveOutOpen-Funktion zurückgegeben wird.
MIXER_OBJECTF_MIDIIN	Der hmxobj-Parameter ist der Bezeichner eines MIDI-Eingabegeräts. Dieser Bezeichner muss sich im Bereich von 0 bis eins unter der Anzahl der Geräte befinden, die von der midiInGetNumDevs-Funktion zurückgegeben werden.
MIXER_OBJECTF_MIDIOUT	Der hmxobj-Parameter ist der Bezeichner eines MIDI-Ausgabegeräts. Dieser Bezeichner muss sich im Bereich von null bis eins unter der Anzahl der Geräte befinden, die von der midiOutGetNumDevs-Funktion zurückgegeben werden.
MIXER_OBJECTF_MIXER	Der hmxobj-Parameter ist der Bezeichner eines Mixergeräts im Bereich von 0 bis eins kleiner als die Anzahl von Geräten, die von der mixerGetNumDevs-Funktion zurückgegeben werden. Dieses Flag ist optional.
MIXER_OBJECTF_WAVEIN	Der hmxobj-Parameter ist der Bezeichner eines Waveform-Audio-Eingabegeräts im Bereich von 0 bis eins kleiner als die Anzahl von Geräten, die von der waveInGetNumDevs-Funktion zurückgegeben werden.
MIXER_OBJECTF_WAVEOUT	Der hmxobj-Parameter ist der Bezeichner eines Waveform-Audioausgabegeräts im Bereich von 0 bis eins kleiner als die Anzahl von Geräten, die von der waveOutGetNumDevs-Funktion zurückgegeben werden.

Rückgabewert

Gibt MMSYSERR_NOERROR zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist. Mögliche Fehlerwerte sind:

Rückgabecode	Beschreibung
MIXERR_INVALCONTROL	Der Steuerelementverweis ist ungültig.
MMSYSERR_BADDEVICEID	Der hmxobj-Parameter gibt einen ungültigen Gerätebezeichner an.
MMSYSERR_INVALFLAG	Mindestens ein Flag ist ungültig.
MMSYSERR_INVALHANDLE	Der hmxobj-Parameter gibt ein ungültiges Handle an.
MMSYSERR_INVALPARAM	Mindestens ein Parameter ist ungültig.
MMSYSERR_NODRIVER	Für das von hmxobj angegebene Objekt ist kein Mixergerät verfügbar.

Hinweise

Alle Member der MIXERCONTROLDETAILS-Struktur müssen initialisiert werden, bevor diese Funktion aufgerufen wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mmeapi.h (include Mmeapi.h, Windows.h)
Bibliothek	Winmm.lib
DLL	Winmm.dll

Weitere Informationen

Audiomixerfunktionen

Audiomixer