mixerSetControlDetails-Funktion (mmeapi.h)
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 |
|---|---|
|
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 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 |