mixerGetLineControlsA 함수(mmeapi.h)
mixerGetLineControls 함수는 오디오 라인과 연결된 하나 이상의 컨트롤을 검색합니다.
구문
MMRESULT mixerGetLineControlsA(
HMIXEROBJ hmxobj,
LPMIXERLINECONTROLSA pmxlc,
DWORD fdwControls
);
매개 변수
hmxobj
쿼리 중인 믹서 디바이스 개체에 대한 핸들입니다.
pmxlc
MIXERLINECONTROLS 구조체에 대한 포인터입니다. 이 구조체는 오디오 라인과 연결된 컨트롤에 대한 정보로 채워질 하나 이상의 MIXERCONTROL 구조를 참조하는 데 사용됩니다. MIXERLINECONTROLS 구조체의 cbStruct 멤버는 MIXERLINECONTROLS 구조체의 크기(바이트)로 항상 초기화되어야 합니다.
fdwControls
오디오 라인과 연결된 하나 이상의 컨트롤에 대한 정보를 검색하기 위한 플래그입니다. 다음 값이 정의됩니다.
| 값 | 의미 |
|---|---|
| MIXER_GETLINECONTROLSF_ALL | pmxlc 매개 변수는 MIXERLINECONTROL 구조체의 dwLineID 멤버로 식별된 오디오 라인과 연결된 모든 컨트롤에 대한 정보를 수신하는 MIXERCONTROL 구조 목록을 참조합니다. cControls 멤버는 줄과 연결된 컨트롤 수로 초기화되어야 합니다. 이 숫자는 mixerGetLineInfo 함수에서 반환된 MIXERLINE 구조체의 cControls 멤버에서 검색됩니다. cbmxctrl 멤버는 단일 MIXERCONTROL 구조체의 크기(바이트)로 초기화되어야 합니다. pamxctrl 멤버는 채워질 첫 번째 MIXERCONTROL 구조를 가리킵니다. 이 쿼리에는 dwControlID 및 dwControlType 멤버가 무시됩니다. |
| MIXER_GETLINECONTROLSF_ONEBYID | pmxlc 매개 변수는 MIXERLINECONTROL 구조체의 dwControlID 멤버로 식별된 컨트롤에 대한 정보를 수신하는 단일 MIXERCONTROL 구조를 참조합니다. cControls 멤버를 1로 초기화해야 합니다. cbmxctrl 멤버는 단일 MIXERCONTROL 구조체의 크기(바이트)로 초기화되어야 합니다. pamxctrl 멤버는 채울 MIXERCONTROL 구조를 가리킵니다. 이 쿼리에는 dwLineID 및 dwControlType 멤버가 무시됩니다. 이 쿼리는 일반적으로 사용자 정의 콜백에서 MM_MIXM_CONTROL_CHANGE 컨트롤 변경 알림 메시지를 받은 후 컨트롤을 새로 고치는 데 사용됩니다( mixerOpen 참조). |
| MIXER_GETLINECONTROLSF_ONEBYTYPE | mixerGetLineControls 함수는 쿼리 중인 오디오 라인에 대한 특정 클래스의 첫 번째 컨트롤에 대한 정보를 검색합니다. pmxlc 매개 변수는 특정 컨트롤에 대한 정보를 수신하는 단일 MIXERCONTROL 구조를 참조합니다. 오디오 라인은 dwLineID 멤버로 식별됩니다. 컨트롤 클래스는 MIXERLINECONTROLS 구조체의 dwControlType 멤버에 지정됩니다. 이 쿼리에는 dwControlID 멤버가 무시됩니다. 이 쿼리는 애플리케이션에서 줄과 연결된 단일 컨트롤에 대한 정보를 가져오는 데 사용할 수 있습니다. 예를 들어 애플리케이션에서 파형 오디오 출력 줄의 최대 측정기만 사용하도록 할 수 있습니다. |
| 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개 적은 범위의 파형 오디오 출력 디바이스의 식별자입니다. |
반환 값
성공하면 MMSYSERR_NOERROR 반환하고, 그렇지 않으면 오류를 반환합니다. 가능한 오류 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
컨트롤 참조가 잘못되었습니다. |
|
오디오 라인 참조가 잘못되었습니다. |
|
hmxobj 매개 변수는 잘못된 디바이스 식별자를 지정합니다. |
|
하나 이상의 플래그가 잘못되었습니다. |
|
hmxobj 매개 변수는 잘못된 핸들을 지정합니다. |
|
하나 이상의 매개 변수가 잘못되었습니다. |
|
hmxobj로 지정된 개체에 사용할 수 있는 믹서 디바이스가 없습니다. |
설명
참고
mmeapi.h 헤더는 mixerGetLineControls를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mmeapi.h(Windows.h 포함) |
| 라이브러리 | Winmm.lib |
| DLL | Winmm.dll |