Share via

MIXERLINE 구조체(mmeapi.h)

  • 아티클

MIXERLINE 구조체는 오디오 라인의 상태 및 메트릭을 설명합니다.

구문

typedef struct tMIXERLINE {
  DWORD  cbStruct;
  DWORD  dwDestination;
  DWORD  dwSource;
  DWORD  dwLineID;
  DWORD  fdwLine;
  DWORD  dwUser;
  DWORD  dwComponentType;
  DWORD  cChannels;
  DWORD  cConnections;
  DWORD  cControls;
  char   szShortName[MIXER_SHORT_NAME_CHARS];
  char   szName[MIXER_LONG_NAME_CHARS];
  struct {
    DWORD   dwType;
    DWORD   dwDeviceID;
    WORD    wMid;
    WORD    wPid;
    VERSION vDriverVersion;
    char    szPname[MAXPNAMELEN];
  } Target;
} MIXERLINE, *PMIXERLINE, *LPMIXERLINE;

멤버

cbStruct

MIXERLINE 구조체의 크기(바이트)입니다. mixerGetLineInfo 함수를 호출하기 전에 이 멤버를 초기화해야 합니다. 이 멤버에 지정된 크기는 MIXERLINE 구조를 포함할 수 있을 만큼 커야 합니다. mixerGetLineInfo가 반환되면 이 멤버는 반환된 정보의 실제 크기를 포함합니다. 반환된 정보는 요청된 크기를 초과하지 않습니다.

dwDestination

대상 줄 인덱스입니다. 이 멤버의 범위는 mixerGetDevCaps 함수에 의해 검색된 MIXERCAPS 구조체의 cDestinations 멤버에 지정된 값보다 0에서 1보다 작습니다. mixerGetLineInfo 함수가 MIXER_GETLINEINFOF_DESTINATION 플래그를 사용하여 호출되면 대상 줄의 속성이 반환됩니다. 이 경우 dwSource 멤버를 0으로 설정해야 합니다. MIXER_GETLINEINFOF_SOURCE 플래그를 사용하여 호출하면 dwDestination 멤버와 연결된 dwSource 멤버가 제공한 원본에 대한 속성이 반환됩니다.

dwSource

dwDestination 멤버와 연결된 오디오 소스 줄의 인덱스입니다. 즉, 이 멤버는 지정된 오디오 대상 줄과 연결된 n번째 오디오 원본 줄을 지정합니다. 이 멤버는 대상 줄에 사용되지 않으며 mixerGetLineInfo 함수에 MIXER_GETLINEINFOF_DESTINATION 지정된 경우 0으로 설정해야 합니다. MIXER_GETLINEINFOF_SOURCE 플래그를 지정하면 이 멤버는 dwDestination 멤버에 지정된 오디오 대상 줄의 cConnections 멤버에 지정된 값보다 0부터 1까지 범위가 지정됩니다.

dwLineID

MIXERLINE 구조에서 설명하는 오디오 라인을 고유하게 참조하는 믹서 디바이스에서 정의한 식별자입니다. 이 식별자는 각 믹서 디바이스에 대해 고유하며 모든 형식일 수 있습니다. 애플리케이션은 이 식별자를 추상 핸들로만 사용해야 합니다.

fdwLine

오디오 라인의 상태 및 지원 플래그입니다. 이 멤버는 항상 애플리케이션에 반환되며 초기화가 필요하지 않습니다.

Name Description
MIXERLINE_LINEF_ACTIVE
 오디오 라인이 활성화되어 있습니다. 활성 선은 신호가 선을 통과하고 있음을 나타냅니다.
MIXERLINE_LINEF_DISCONNECTED
 오디오 줄의 연결이 끊어졌습니다. 연결이 끊긴 줄의 연결된 컨트롤은 계속 수정할 수 있지만 줄이 연결될 때까지 변경 내용이 적용되지 않습니다.
MIXERLINE_LINEF_SOURCE
 오디오 선은 단일 오디오 대상 라인과 연결된 오디오 소스 라인입니다. 이 플래그가 설정되지 않은 경우 이 줄은 0개 이상의 오디오 소스 라인과 연결된 오디오 대상 줄입니다.
 

애플리케이션이 파형 오디오 출력 디바이스를 사용하지 않는 경우 해당 디바이스와 연결된 오디오 라인이 활성화되지 않습니다(즉, MIXERLINE_LINEF_ACTIVE 플래그가 설정되지 않음).

파형 오디오 출력 디바이스가 열리면 오디오 선이 활성으로 간주되고 MIXERLINE_LINEF_ACTIVE 플래그가 설정됩니다.

일시 중지되거나 굶주린 파형 오디오 출력 디바이스는 여전히 활성으로 간주됩니다. 즉, 데이터가 재생되고 있는지 여부에 관계없이 애플리케이션에서 파형 오디오 출력 디바이스를 열면 연결된 오디오 라인이 활성으로 간주됩니다.

선을 활성으로 엄격하게 정의할 수 없는 경우 믹서 디바이스는 항상 MIXERLINE_LINEF_ACTIVE 플래그를 설정합니다.

dwUser

회선에 대한 오디오 디바이스에서 정의한 인스턴스 데이터입니다. 이 멤버는 이 정보를 반환하는 믹서 디바이스용으로 특별히 설계된 사용자 지정 믹서 애플리케이션을 위한 것입니다. 다른 애플리케이션은 이 데이터를 무시해야 합니다.

dwComponentType

이 오디오 라인의 구성 요소 유형입니다. 애플리케이션은 이 정보를 사용하여 맞춤형 그래픽을 표시하거나 특정 구성 요소를 검색할 수 있습니다. 애플리케이션에서 구성 요소 형식을 사용하지 않는 경우 이 멤버를 무시해야 합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

Name Description
MIXERLINE_COMPONENTTYPE_DST_DIGITAL
 오디오 라인은 디지털 대상(예: DAT 또는 CD 오디오 디바이스에 대한 디지털 입력)입니다.
MIXERLINE_COMPONENTTYPE_DST_HEADPHONES
 오디오 라인은 헤드폰을 구동하기 위한 조정 가능한(게인 및/또는 감쇠) 대상입니다. 대부분의 오디오 카드는 스피커와 헤드폰에 동일한 오디오 대상 라인을 사용하며, 이 경우 믹서 장치는 단순히 MIXERLINE_COMPONENTTYPE_DST_SPEAKERS 유형을 사용합니다.
MIXERLINE_COMPONENTTYPE_DST_LINE
 오디오 라인은 ADC(아날로그-디지털 변환기)의 최종 녹음 소스가 될 선 수준 대상(예: CD 오디오 디바이스의 선 수준 입력)입니다. 개인용 컴퓨터용 대부분의 오디오 카드는 녹음 오디오 소스 라인에 일종의 게인을 제공하기 때문에 믹서 장치는 MIXERLINE_COMPONENTTYPE_DST_WAVEIN 유형을 사용합니다.
MIXERLINE_COMPONENTTYPE_DST_MONITOR
 오디오 라인은 모니터에 사용되는 대상입니다.
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS
 오디오 라인은 스피커를 구동하기 위한 조정 가능한(게인 및/또는 감쇠) 대상입니다. 개인용 컴퓨터용 오디오 카드의 오디오 출력에 대한 일반적인 구성 요소 유형입니다.
MIXERLINE_COMPONENTTYPE_DST_TELEPHONE
 오디오 회선은 전화선으로 라우팅되는 대상입니다.
MIXERLINE_COMPONENTTYPE_DST_UNDEFINED
 오디오 선은 표준 구성 요소 유형 중 하나로 정의할 수 없는 대상입니다. Microsoft Corporation에서 정의하지 않은 선 구성 요소 유형에 이 구성 요소 유형을 사용하려면 믹서 디바이스가 필요합니다.
MIXERLINE_COMPONENTTYPE_DST_VOICEIN
 오디오 라인은 음성 입력의 최종 녹음 소스가 될 대상입니다. 이 구성 요소 유형은 정확히 MIXERLINE_COMPONENTTYPE_DST_WAVEIN 같지만 음성 녹음/인식 중에 사용되는 설정에만 사용됩니다. 이 줄에 대한 지원은 믹서 디바이스에 대한 선택 사항입니다. 많은 믹서 디바이스는 MIXERLINE_COMPONENTTYPE_DST_WAVEIN 제공합니다.
MIXERLINE_COMPONENTTYPE_DST_WAVEIN
 오디오 선은 ADC(파형 오디오 입력)의 최종 녹음 원본이 될 대상입니다. 이 줄은 일반적으로 일종의 게인 또는 감쇠를 제공합니다. 개인용 컴퓨터용 대부분의 오디오 카드 녹음줄에 대한 일반적인 구성 요소 유형입니다.
MIXERLINE_COMPONENTTYPE_SRC_ANALOG
 오디오 선은 아날로그 소스(예: 비디오 카세트 테이프의 아날로그 출력)입니다.
MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY
 오디오 라인은 보조 오디오 라인에서 시작되는 소스입니다. 이 줄 형식은 MIXERLINE_COMPONENTTYPE_DST_SPEAKERS 대상으로 라우팅되거나 MIXERLINE_COMPONENTTYPE_DST_WAVEIN 대상에서 기록될 수 있는 게인 또는 감쇠가 있는 원본으로 의도됩니다.
MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC
 오디오 라인은 내부 오디오 CD의 출력에서 시작되는 소스입니다. 이 구성 요소 유형은 오디오 CD(또는 오디오 CD를 재생하는 CD-ROM)에 연결하기 위한 오디오 소스 라인을 제공하는 오디오 카드에 제공됩니다.
MIXERLINE_COMPONENTTYPE_SRC_DIGITAL
 오디오 라인은 디지털 소스(예: DAT 또는 오디오 CD의 디지털 출력)입니다.
MIXERLINE_COMPONENTTYPE_SRC_LINE
 오디오 선은 선택적 녹음 소스로 사용할 수 있는 선 수준 소스(예: 외부 스테레오의 줄 수준 입력)입니다. 개인용 컴퓨터용 대부분의 오디오 카드는 녹음 소스 라인에 일종의 게인을 제공하기 때문에 믹서 장치는 MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY 유형을 사용합니다.
MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE
 오디오 라인은 마이크 녹음 소스입니다. 개인용 컴퓨터용 대부분의 오디오 카드는 보조 오디오 라인 및 마이크 입력의 두 가지 이상의 녹음 소스를 제공합니다. 마이크 오디오 라인은 일반적으로 일종의 게인을 제공합니다. 마이크 또는 보조 오디오 라인에 사용하기 위해 단일 입력을 사용하는 오디오 카드는 MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE 구성 요소 유형을 사용해야 합니다.
MIXERLINE_COMPONENTTYPE_SRC_PCSPEAKER
 오디오 라인은 개인용 컴퓨터 스피커에서 시작되는 소스입니다. 개인용 컴퓨터용 여러 오디오 카드는 일반적으로 내부 스피커에서 재생되는 것을 오디오 카드 출력과 혼합하는 기능을 제공합니다. 일부 오디오 카드는 이 출력을 녹음 소스로 사용하는 기능을 지원합니다.
MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER
 오디오 선은 내부 신시사이저의 출력에서 시작되는 소스입니다. 개인용 컴퓨터용 대부분의 오디오 카드는 일종의 MIDI 신시사이저를 제공합니다.
MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE
 오디오 회선은 수신 전화선에서 시작되는 소스입니다.
MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED
 오디오 선은 표준 구성 요소 유형 중 하나로 정의할 수 없는 소스입니다. Microsoft Corporation에서 정의하지 않은 선 구성 요소 유형에 이 구성 요소 유형을 사용하려면 믹서 디바이스가 필요합니다.
MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT
 오디오 선은 파형-오디오 출력 DAC(디지털-아날로그 변환기)에서 시작되는 소스입니다. 개인용 컴퓨터용 대부분의 오디오 카드는 이 구성 요소 유형을 MIXERLINE_COMPONENTTYPE_DST_SPEAKERS 대상의 원본으로 제공합니다. 일부 카드는 이 원본을 MIXERLINE_COMPONENTTYPE_DST_WAVEIN 대상으로 라우팅할 수도 있습니다.

cChannels

오디오 라인에 대해 독립적으로 조작할 수 있는 최대 개별 채널 수입니다. 줄에 채널이 하나 이상 있어야 하므로 이 필드의 최소값은 1입니다.

개인용 컴퓨터용 최신 오디오 카드는 스테레오 디바이스입니다. 이 멤버의 값은 2입니다.

채널 1은 왼쪽 채널로 간주됩니다. 채널 2는 올바른 채널로 간주됩니다.

다중 채널 선에는 하나 이상의 균일한 컨트롤(선의 모든 채널에 균일하게 영향을 주는 컨트롤)이 연결되어 있을 수 있습니다.

cConnections

오디오 라인과 연결된 연결 수입니다. 이 멤버는 오디오 대상 줄에만 사용되며 연결된 오디오 원본 줄의 수를 지정합니다. 이 멤버는 원본 줄과 연결된 오디오 소스 줄이 없는 대상 줄에 대해 항상 0입니다.

cControls

오디오 라인과 연결된 컨트롤의 수입니다. 이 값은 0일 수 있습니다. 선과 연결된 컨트롤이 없는 경우 선은 MIXERCONTROL_CONTROLTYPE_MUX 또는 MIXERCONTROL_CONTROLTYPE_MIXER 선택될 수 있지만 신호 조작을 허용하지 않는 원본일 수 있습니다.

szShortName[MIXER_SHORT_NAME_CHARS]

dwLineID 멤버에 지정된 오디오 믹서 줄을 설명하는 짧은 문자열입니다. 이 설명은 줄에 대한 간결한 레이블로 적합해야 합니다.

szName[MIXER_LONG_NAME_CHARS]

dwLineID 멤버에 지정된 오디오 믹서 줄을 설명하는 문자열입니다. 이 설명은 줄에 대한 전체 설명으로 적합해야 합니다.

Target

대상 미디어 정보입니다.

Target.dwType

MIXERLINE 구조에 설명된 오디오 라인과 연결된 대상 미디어 디바이스 유형입니다. 애플리케이션은 사용하지 않는 미디어 디바이스 유형에 대한 대상 정보를 무시해야 합니다. 다음 값이 정의됩니다.

Name Description
MIXERLINE_TARGETTYPE_AUX
 MIXERLINE 구조체에서 설명하는 오디오 라인은 MIXERLINE 구조체의 대상 구조체 멤버의 나머지 멤버에 자세히 설명된 보조 디바이스에 엄격하게 바인딩됩니다.
MIXERLINE_TARGETTYPE_MIDIIN
 MIXERLINE 구조체에서 설명하는 오디오 라인은 MIXERLINE 구조체의 대상 구조체 멤버의 나머지 멤버에 자세히 설명된 MIDI 입력 장치에 엄격하게 바인딩됩니다.
MIXERLINE_TARGETTYPE_MIDIOUT
 MIXERLINE 구조체에서 설명하는 오디오 라인은 MIXERLINE 구조체의 대상 구조체 멤버의 나머지 멤버에 자세히 설명된 MIDI 출력 디바이스에 엄격하게 바인딩됩니다.
MIXERLINE_TARGETTYPE_UNDEFINED
 MIXERLINE 구조에서 설명하는 오디오 라인은 정의된 미디어 형식에 엄격하게 바인딩되지 않습니다. MIXERLINE 구조체의 나머지 대상 구조체 멤버는 모두 무시해야 합니다. 애플리케이션은 MIXER_GETLINEINFOF_TARGETTYPE 플래그를 사용하여 mixerGetLineInfo 함수를 호출할 때 MIXERLINE_TARGETTYPE_UNDEFINED 대상 형식을 사용할 수 없습니다.
MIXERLINE_TARGETTYPE_WAVEIN
 MIXERLINE 구조체에 의해 설명된 오디오 라인은 MIXERLINE 구조체의 대상 구조체 멤버의 나머지 멤버에 자세히 설명된 파형 오디오 입력 장치에 엄격하게 바인딩됩니다.
MIXERLINE_TARGETTYPE_WAVEOUT
 MIXERLINE 구조체에서 설명하는 오디오 라인은 MIXERLINE 구조체의 대상 구조체 멤버의 나머지 멤버에 자세히 설명된 파형 오디오 출력 디바이스에 엄격하게 바인딩됩니다.

Target.dwDeviceID

dwType 멤버가 MIXERLINE_TARGETTYPE_UNDEFINED 이외의 대상 형식인 경우 대상 미디어 디바이스의 현재 디바이스 식별자입니다. 이 식별자는 연결된 미디어 디바이스의 현재 미디어 디바이스 인덱스와 동일합니다. MIXER_GETLINEINFOF_TARGETTYPE 플래그를 사용하여 mixerGetLineInfo 함수를 호출할 때 이 멤버는 입력 시 무시되며 오디오 믹서 관리자가 호출자에게 반환합니다.

Target.wMid

dwType 멤버가 MIXERLINE_TARGETTYPE_UNDEFINED 이외의 대상 형식인 경우 대상 미디어 디바이스의 제조업체 식별자입니다. 이 식별자는 연결된 미디어에 대한 디바이스 기능 구조의 wMid 멤버와 동일합니다. 제조업체 식별자는 제조업체 및 제품 식별자에 정의되어 있습니다.

Target.wPid

dwType 멤버가 MIXERLINE_TARGETTYPE_UNDEFINED 이외의 대상 형식인 경우 대상 미디어 디바이스의 제품 식별자입니다. 이 식별자는 연결된 미디어에 대한 디바이스 기능 구조의 wPid 멤버와 동일합니다. 제품 식별자는 제조업체 및 제품 식별자에 정의되어 있습니다.

Target.vDriverVersion

dwType 멤버가 MIXERLINE_TARGETTYPE_UNDEFINED 이외의 대상 형식인 경우 대상 미디어 디바이스의 드라이버 버전입니다. 이 버전은 연결된 미디어에 대한 디바이스 기능 구조의 vDriverVersion 멤버와 동일합니다.

Target.szPname[MAXPNAMELEN]

dwType 멤버가 MIXERLINE_TARGETTYPE_UNDEFINED 이외의 대상 형식인 경우 대상 미디어 디바이스의 제품 이름입니다. 이 이름은 연결된 미디어에 대한 디바이스 기능 구조의 szPname 멤버와 동일합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
머리글 mmeapi.h

추가 정보

오디오 믹서 구조체

오디오 믹서

MIXERCAPS

mixerGetDevCaps

mixerGetLineInfo