mixerSetControlDetails-Funktion (mmeapi.h)

  • Artikel

Die mixerSetControlDetails-Funktion legt Eigenschaften eines einzelnen Steuerelements fest, das einer Audiolinie zugeordnet ist.

Syntax

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

Parameter

hmxobj

Handle mit dem Mixergerätobjekt, für das Eigenschaften festgelegt werden.

pmxcd

Zeiger auf eine MIXERCONTROLDETAILS-Struktur . Diese Struktur wird verwendet, um auf Steuerelementdetailstrukturen zu verweisen, die den gewünschten Zustand für das Steuerelement enthalten.

fdwDetails

Flags zum Festlegen von Eigenschaften für ein Steuerelement. Die folgenden Werte werden definiert.

Wert Bedeutung
MIXER_OBJECTF_AUX Der hmxobj-Parameter ist ein Hilfsgerätebezeichner im Bereich von null bis eins kleiner als die Anzahl von Geräten, die von der auxGetNumDevs-Funktion zurückgegeben werden.
MIXER_OBJECTF_HMIDIIN Der hmxobj-Parameter ist das Handle eines MIDI-Eingabegeräts. 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 Von der mixerOpen-Funktion zurückgegebenes Mischerhandle. 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-Audioausgabehandle, 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 null bis eins unter der Anzahl der von der midiInGetNumDevs-Funktion zurückgegebenen Geräte befinden.
MIXER_OBJECTF_MIDIOUT Der hmxobj-Parameter ist der Bezeichner eines MIDI-Ausgabegeräts. Dieser Bezeichner muss sich im Bereich von null bis 1 kleiner als die Anzahl der von der midiOutGetNumDevs-Funktion zurückgegebenen Geräte befinden.
MIXER_OBJECTF_MIXER Der hmxobj-Parameter ist ein Mixergerätebezeichner im Bereich von null bis eins kleiner als die Anzahl der geräte, 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 null 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 null bis eins kleiner als die Anzahl von Geräten, die von der waveOutGetNumDevs-Funktion zurückgegeben werden.
MIXER_SETCONTROLDETAILSF_CUSTOM Ein benutzerdefiniertes Dialogfeld für das angegebene benutzerdefinierte Mixer-Steuerelement wird angezeigt. Das Mixergerät sammelt die erforderlichen Informationen vom Benutzer und gibt die Daten im angegebenen Puffer zurück. Das Handle für das Besitzerfenster wird im hwndOwner-Element der MIXERCONTROLDETAILS-Struktur angegeben. (Dieses Handle kann auf NULL festgelegt werden.) Die Anwendung kann dann die Daten aus dem Dialogfeld speichern und später verwenden, um das Steuerelement mithilfe des MIXER_SETCONTROLDETAILSF_VALUE-Flags auf denselben Zustand zurückzusetzen.
MIXER_SETCONTROLDETAILSF_VALUE Die aktuellen Werte für ein Steuerelement werden festgelegt. Das paDetails-Element der MIXERCONTROLDETAILS-Struktur verweist auf mindestens eine Mixer-Steuerelement-Detailstruktur der entsprechenden Klasse für das Steuerelement.

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 Elemente der MIXERCONTROLDETAILS-Struktur müssen initialisiert werden, bevor mixerSetControlDetails aufgerufen wird.

Wenn eine Anwendung nur den aktuellen Zustand eines benutzerdefinierten Mixer-Steuerelements abrufen und kein Dialogfeld anzeigen muss, kann mixerGetControlDetails mit dem flag MIXER_GETCONTROLDETAILSF_VALUE verwendet werden.

Anforderungen

Anforderung Wert
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 (einschließlich Windows.h)
Bibliothek Winmm.lib
DLL Winmm.dll

Weitere Informationen

Audiomischerfunktionen

Audiomischer