mixerGetLineInfoA 함수(mmeapi.h)
mixerGetLineInfo 함수는 믹서 디바이스의 특정 줄에 대한 정보를 검색합니다.
구문
MMRESULT mixerGetLineInfoA(
HMIXEROBJ hmxobj,
LPMIXERLINEA pmxl,
DWORD fdwInfo
);
매개 변수
hmxobj
특정 오디오 라인을 제어하는 믹서 디바이스 개체에 대한 핸들입니다.
pmxl
MIXERLINE 구조체에 대한 포인터입니다. 이 구조는 믹서 장치의 오디오 라인에 대한 정보로 채워집니다. cbStruct 멤버는 MIXERLINE 구조체의 크기(바이트)로 항상 초기화되어야 합니다.
fdwInfo
오디오 라인에 대한 정보를 검색하기 위한 플래그입니다. 다음 값이 정의됩니다.
| 값 | 의미 |
|---|---|
| MIXER_GETLINEINFOF_COMPONENTTYPE | pmxl 매개 변수는 MIXERLINE 구조체의 dwComponentType 멤버에 지정된 형식의 첫 번째 오디오 줄에 대한 정보를 받습니다. 이 플래그는 특정 구성 요소 유형의 오디오 줄에 대한 정보를 검색하는 데 사용됩니다. cbStruct를 제외한 나머지 구조체 멤버는 더 이상 초기화할 필요가 없습니다. |
| MIXER_GETLINEINFOF_DESTINATION | pmxl 매개 변수는 MIXERLINE 구조체의 dwDestination 멤버가 지정한 대상 오디오 라인에 대한 정보를 수신합니다. 이 인덱스는 MIXERCAPS 구조체의 cDestinations 멤버 값보다 0부터 1까지 다양합니다. cbStruct를 제외한 나머지 모든 구조체 멤버는 더 이상 초기화할 필요가 없습니다. |
| MIXER_GETLINEINFOF_LINEID | pmxl 매개 변수는 MIXERLINE 구조체의 dwLineID 멤버가 지정한 오디오 줄에 대한 정보를 받습니다. 일반적으로 오디오 라인의 상태에 대한 업데이트된 정보를 검색하는 데 사용됩니다. cbStruct를 제외한 나머지 모든 구조체 멤버는 더 이상 초기화할 필요가 없습니다. |
| MIXER_GETLINEINFOF_SOURCE | pmxl 매개 변수는 MIXERLINE 구조체의 dwDestination 및 dwSource 멤버로 지정된 원본 오디오 라인에 대한 정보를 받습니다. dwDestination으로 지정된 인덱스는 MIXERCAPS 구조체의 cDestinations 멤버 값보다 0부터 1까지 다양합니다. dwSource에서 지정한 인덱스는 dwDestination 멤버에 저장된 오디오 줄에 대해 반환된 MIXERLINE 구조체의 cConnections 멤버 값보다 0부터 1까지 다양합니다. cbStruct를 제외한 나머지 모든 구조체 멤버는 더 이상 초기화할 필요가 없습니다. |
| MIXER_GETLINEINFOF_TARGETTYPE | pmxl 매개 변수는 MIXERLINE 구조체의 멤버인 대상 구조체의 dwType 멤버에 대한 오디오 줄에 대한 정보를 수신합니다. 이 플래그는 대상 형식(예: MIXERLINE_TARGETTYPE_WAVEOUT)을 처리하는 오디오 줄에 대한 정보를 검색하는 데 사용됩니다. 애플리케이션은 mixerGetLineInfo를 호출하기 전에 MIXERLINE 구조체의 dwType, wMid, wPid, vDriverVersion 및 szPname 멤버를 초기화해야 합니다. 이러한 모든 값은 모든 미디어 디바이스에 대한 디바이스 기능 구조에서 검색할 수 있습니다. cbStruct를 제외한 나머지 구조체 멤버는 더 이상 초기화할 필요가 없습니다.
참고 이 함수의 ANSI 버전(mixerGetLineInfoA)에서는 MIXER_GETLINEINFOF_TARGETTYPE 플래그를 사용하여 mixerGetLineInfo를 호출할 때 psPname 문자열 값에 mixerGetLineInfo 또는 waveOutGetDevCaps에서 반환된 ANSI 문자열을 사용할 수 없습니다. 유니코드로의 내부 변환이 수행되어 데이터가 손실될 수 있기 때문입니다.
|
| 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 헤더는 mixerGetLineInfo를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mmeapi.h(Windows.h 포함) |
| 라이브러리 | Winmm.lib |
| DLL | Winmm.dll |