Share via

MIXERLINECONTROLSA 구조체(mmeapi.h)

  • 아티클

MIXERLINECONTROLS 구조체에는 오디오 라인의 컨트롤에 대한 정보가 포함됩니다.

구문

typedef struct tagMIXERLINECONTROLSA {
  DWORD           cbStruct;
  DWORD           dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  } DUMMYUNIONNAME;
  DWORD           cControls;
  DWORD           cbmxctrl;
  LPMIXERCONTROLA pamxctrl;
} MIXERLINECONTROLSA, *PMIXERLINECONTROLSA, *LPMIXERLINECONTROLSA;

멤버

cbStruct

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

dwLineID

컨트롤이 쿼리되는 줄 식별자입니다. mixerGetLineControls 함수에 대해 MIXER_GETLINECONTROLSF_ONEBYID 플래그를 지정한 경우 이 멤버는 사용되지 않지만 믹서 디바이스는 이 경우 이 멤버를 여전히 반환합니다. MIXER_GETLINECONTROLSF_ALL 지정하면 dwControlID 및 dwControlType 멤버가 사용되지 않습니다.

DUMMYUNIONNAME

DUMMYUNIONNAME.dwControlID

원하는 컨트롤의 컨트롤 식별자입니다. 이 멤버는 mixerGetLineControls 함수에 대한 MIXER_GETLINECONTROLSF_ONEBYID 플래그와 함께 사용하여 지정된 컨트롤의 컨트롤 정보를 검색합니다. MIXERLINECONTROLS 구조체의 dwLineID 멤버는 믹서 디바이스에서 반환되며 입력 매개 변수로 필요하지 않습니다. 이 멤버는 dwControlType 멤버와 겹치며 MIXER_GETLINECONTROLSF_ONEBYTYPE 쿼리 형식과 함께 사용할 수 없습니다.

DUMMYUNIONNAME.dwControlType

원하는 컨트롤 형식의 클래스입니다. 이 멤버는 mixerGetLineControls 함수에 대한 MIXER_GETLINECONTROLSF_ONEBYTYPE 플래그와 함께 사용하여 MIXERLINECONTROLS 구조체의 dwLineID 멤버가 지정한 줄에서 지정된 클래스의 첫 번째 컨트롤을 검색합니다. 이 멤버는 dwControlID 멤버와 겹치며 MIXER_GETLINECONTROLSF_ONEBYID 쿼리 형식과 함께 사용할 수 없습니다. MIXERCONTROL에서 dwControlType 멤버 설명을 참조하세요.

cControls

검색할 MIXERCONTROL 구조 요소의 수입니다. mixerGetLineControls 함수를 호출하기 전에 애플리케이션에서 이 멤버를 초기화해야 합니다. 이 멤버는 MIXER_GETLINECONTROLSF_ONEBYID 또는 MIXER_GETLINECONTROLSF_ONEBYTYPE 지정되거나 오디오 라인에 대해 반환된 MIXERLINE 구조체의 cControls 멤버에 반환된 값인 경우에만 1일 수 있습니다. 이 멤버는 0일 수 없습니다. 오디오 라인이 컨트롤이 없음을 지정하는 경우 mixerGetLineControls를 호출하면 안 됩니다.

cbmxctrl

단일 MIXERCONTROL 구조체의 크기(바이트)입니다. 이 멤버에 지정된 크기는 기본 MIXERCONTROL 구조를 포함할 만큼 충분히 커야 합니다. pamxctrl 멤버가 가리키는 버퍼에 필요한 총 크기(바이트)는 MIXERLINECONTROLS 구조체의 cbmxctrl 및 cControls 멤버의 곱입니다.

pamxctrl

요청된 오디오 라인 컨트롤의 속성을 수신하는 하나 이상의 MIXERCONTROL 구조체에 대한 포인터입니다. 이 멤버는 NULL 일 수 없으며 mixerGetLineControls 함수를 호출하기 전에 초기화해야 합니다. 컨트롤 배열의 각 요소는 기본 MIXERCONTROL 구조를 포함할 만큼 충분히 커야 합니다. cbmxctrl 멤버는 이 배열에 있는 각 요소의 크기를 바이트 단위로 지정해야 합니다. 애플리케이션에서 이 멤버가 가리키는 버퍼를 초기화할 필요가 없습니다. 모든 멤버는 성공적으로 반환되면 믹서 디바이스(각 MIXERCONTROL 구조의 cbStruct 멤버 포함)에 의해 채워집니다.

설명

참고

mmeapi.h 헤더는 MIXERLINECONTROLS를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

추가 정보

오디오 믹서 구조체

오디오 믹서

MIXERCONTROL

MIXERLINE

mixerGetLineControls