mixerGetControlDetails-Funktion (mmeapi.h)
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 |
|---|---|
|
Der Steuerelementverweis ist ungültig. |
|
Der hmxobj-Parameter gibt einen ungültigen Gerätebezeichner an. |
|
Mindestens ein Flag ist ungültig. |
|
Der hmxobj-Parameter gibt ein ungültiges Handle an. |
|
Mindestens ein Parameter ist ungültig. |
|
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 |