MIXERLINECONTROLSW 구조체(mmeapi.h)

MIXERLINECONTROLS 구조체에는 오디오 선의 컨트롤에 대한 정보가 포함되어 있습니다.

통사론

typedef struct tagMIXERLINECONTROLSW {
  DWORD           cbStruct;
  DWORD           dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  } DUMMYUNIONNAME;
  DWORD           cControls;
  DWORD           cbmxctrl;
  LPMIXERCONTROLW pamxctrl;
} MIXERLINECONTROLSW, *PMIXERLINECONTROLSW, *LPMIXERLINECONTROLSW;

회원

cbStruct

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

dwLineID

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

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 쿼리 형식과 함께 사용할 수 없습니다. MIXERCONTROLdwControlType 멤버 설명을 참조하세요.

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 멤버 포함)에 의해 채워집니다.

발언

요구 사항

참고 항목

오디오 믹서 구조

오디오 믹서

MIXERCONTROL

MIXERLINE

mixerGetLineControls