다음을 통해 공유

mixerSetControlDetails 함수(mmeapi.h)

  • 아티클

mixerSetControlDetails 함수는 오디오 라인과 연결된 단일 컨트롤의 속성을 설정합니다.

구문

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

매개 변수

hmxobj

속성이 설정되는 믹서 디바이스 개체에 대한 핸들입니다.

pmxcd

MIXERCONTROLDETAILS 구조체에 대한 포인터입니다. 이 구조체는 컨트롤에 대해 원하는 상태를 포함하는 컨트롤 세부 구조체를 참조하는 데 사용됩니다.

fdwDetails

컨트롤의 속성을 설정하기 위한 플래그입니다. 다음 값이 정의됩니다.

값 의미
MIXER_OBJECTF_AUX hmxobj 매개 변수는 auxGetNumDevs 함수에서 반환된 디바이스 수보다 0~1개 미만인 보조 디바이스 식별자입니다.
MIXER_OBJECTF_HMIDIIN hmxobj 매개 변수는 MIDI 입력 디바이스의 핸들입니다. 이 핸들은 midiInOpen 함수에서 반환되어야 합니다.
MIXER_OBJECTF_HMIDIOUT hmxobj 매개 변수는 MIDI 출력 디바이스의 핸들입니다. 이 핸들은 midiOutOpen 함수에서 반환되어야 합니다.
MIXER_OBJECTF_HMIXER hmxobj 매개 변수는 mixerOpen 함수에서 반환된 믹서 디바이스 핸들입니다. 이 플래그는 선택 사항입니다.
MIXER_OBJECTF_HWAVEIN hmxobj 매개 변수는 waveInOpen 함수에서 반환하는 파형 오디오 입력 핸들입니다.
MIXER_OBJECTF_HWAVEOUT hmxobj 매개 변수는 waveOutOpen 함수에서 반환하는 파형 오디오 출력 핸들입니다.
MIXER_OBJECTF_MIDIIN hmxobj 매개 변수는 MIDI 입력 디바이스의 식별자입니다. 이 식별자는 midiInGetNumDevs 함수에서 반환하는 디바이스 수보다 0에서 1까지의 범위에 있어야 합니다.
MIXER_OBJECTF_MIDIOUT hmxobj 매개 변수는 MIDI 출력 디바이스의 식별자입니다. 이 식별자는 midiOutGetNumDevs 함수에서 반환하는 디바이스 수보다 0에서 1까지의 범위에 있어야 합니다.
MIXER_OBJECTF_MIXER hmxobj 매개 변수는 mixerGetNumDevs 함수에서 반환된 디바이스 수보다 0~1개 미만의 믹서 디바이스 식별자입니다. 이 플래그는 선택 사항입니다.
MIXER_OBJECTF_WAVEIN hmxobj 매개 변수는 waveInGetNumDevs 함수에서 반환하는 디바이스 수보다 0~1보다 작은 파형 오디오 입력 디바이스의 식별자입니다.
MIXER_OBJECTF_WAVEOUT hmxobj 매개 변수는 waveOutGetNumDevs 함수에서 반환된 디바이스 수보다 0~1보다 작은 파형 오디오 출력 디바이스의 식별자입니다.
MIXER_SETCONTROLDETAILSF_CUSTOM 지정된 사용자 지정 믹서 컨트롤에 대한 사용자 지정 대화 상자가 표시됩니다. 믹서 디바이스는 사용자로부터 필요한 정보를 수집하고 지정된 버퍼의 데이터를 반환합니다. 소유 창에 대한 핸들은 MIXERCONTROLDETAILS 구조체의 hwndOwner 멤버에 지정됩니다. (이 핸들은 NULL로 설정할 수 있습니다.) 그런 다음 애플리케이션은 대화 상자에서 데이터를 저장하고 나중에 사용하여 MIXER_SETCONTROLDETAILSF_VALUE 플래그를 사용하여 컨트롤을 동일한 상태로 다시 설정할 수 있습니다.
MIXER_SETCONTROLDETAILSF_VALUE 컨트롤의 현재 값이 설정됩니다. MIXERCONTROLDETAILS 구조체의 paDetails 멤버는 컨트롤에 적합한 클래스의 하나 이상의 믹서 컨트롤 세부 정보 구조를 가리킵니다.

반환 값

성공하거나 오류가 있으면 MMSYSERR_NOERROR 반환합니다. 가능한 오류 값은 다음과 같습니다.

반환 코드 설명
MIXERR_INVALCONTROL
 컨트롤 참조가 잘못되었습니다.
MMSYSERR_BADDEVICEID
 hmxobj 매개 변수는 잘못된 디바이스 식별자를 지정합니다.
MMSYSERR_INVALFLAG
 하나 이상의 플래그가 잘못되었습니다.
MMSYSERR_INVALHANDLE
 hmxobj 매개 변수는 잘못된 핸들을 지정합니다.
MMSYSERR_INVALPARAM
 하나 이상의 매개 변수가 잘못되었습니다.
MMSYSERR_NODRIVER
 hmxobj로 지정된 개체에 사용할 수 있는 믹서 디바이스가 없습니다.

설명

mixerSetControlDetails를 호출하기 전에 MIXERCONTROLDETAILS 구조체의 모든 멤버를 초기화해야 합니다.

애플리케이션이 사용자 지정 믹서 컨트롤의 현재 상태만 검색하고 대화 상자를 표시하지 않으면 mixerGetControlDetails 를 MIXER_GETCONTROLDETAILSF_VALUE 플래그와 함께 사용할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 mmeapi.h(Windows.h 포함)
라이브러리 Winmm.lib
DLL Winmm.dll

추가 정보

오디오 믹서 함수

오디오 믹서