Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |