mixerGetControlDetailsW-Funktion (mmeapi.h)

Artikel
11/20/2024

Die mixerGetControlDetails Funktion ruft Details zu einem einzelnen Steuerelement ab, das einer Audiolinie zugeordnet ist.

Syntax

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

Parameter

hmxobj

Behandeln Des Mixergeräteobjekts, das abgefragt wird.

pmxcd

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

fdwDetails

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

Wert	Bedeutung
MIXER_GETCONTROLDETAILSF_LISTTEXT	Der paDetails Member 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. Der paDetails Member 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 0 bis 1 kleiner als die Anzahl der von der auxGetNumDevs Funktion zurückgegebenen Geräte.
MIXER_OBJECTF_HMIDIIN	Der hmxobj Parameter ist das Handle eines MIDI-Eingabegeräts (Musical Instrument Digital Interface). Dieser Handle muss von der midiInOpen--Funktion zurückgegeben worden sein.
MIXER_OBJECTF_HMIDIOUT	Der hmxobj Parameter ist der Handle eines MIDI-Ausgabegeräts. Dieser Handle muss von der midiOutOpen--Funktion zurückgegeben worden sein.
MIXER_OBJECTF_HMIXER	Der hmxobj Parameter ist ein Mischgeräthandle, das von der funktion mixerOpen zurückgegeben wird. Dieses Kennzeichen ist optional.
MIXER_OBJECTF_HWAVEIN	Der hmxobj Parameter ist ein Waveform-Audio-Eingabepunkt, der von der waveInOpen--Funktion zurückgegeben wird.
MIXER_OBJECTF_HWAVEOUT	Der hmxobj Parameter ist ein Waveform-Audioausgabepunkt, der 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 Null bis 1 kleiner befinden als die Anzahl der Geräte, 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 0 bis 1 kleiner befinden als die Anzahl der Geräte, die von der midiOutGetNumDevs Funktion zurückgegeben werden.
MIXER_OBJECTF_MIXER	Der hmxobj Parameter ist der Bezeichner eines Mischgeräts im Bereich von 0 bis 1 kleiner als die Anzahl der von der mixerGetNumDevs Funktion zurückgegebenen Geräte. Dieses Kennzeichen ist optional.
MIXER_OBJECTF_WAVEIN	Der hmxobj Parameter ist der Bezeichner eines Waveform-Audioeingabegeräts im Bereich von Null bis 1 kleiner als die Anzahl der geräte, die von der waveInGetNumDevs Funktion zurückgegeben werden.
MIXER_OBJECTF_WAVEOUT	Der hmxobj Parameter ist der Bezeichner eines Waveform-Audioausgabegeräts im Bereich von Null bis 1 kleiner als die Anzahl der geräte, die von der waveOutGetNumDevs Funktion zurückgegeben werden.

Rückgabewert

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

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

Bemerkungen

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

Anmerkung

Der mmeapi.h-Header definiert mixerGetControlDetails als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	mmeapi.h (include Mmeapi.h, Windows.h)
Library	Winmm.lib
DLL-	Winmm.dll

Siehe auch

Audiomixerfunktionen

Audiomixer

Freigeben über