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

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

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

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

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

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

dwUser

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

dwComponentType

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

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

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 멤버와 동일합니다.

요구 사항

추가 정보

오디오 믹서 구조체

오디오 믹서

MIXERCAPS

mixerGetDevCaps

mixerGetLineInfo