MIXERCONTROLDETAILS 구조체(mmeapi.h)

MIXERCONTROLDETAILS 구조체는 오디오 믹서 컨트롤의 상태 정보를 검색하거나 설정하는 컨트롤 세부 구조체를 나타냅니다. mixerGetControlDetails 및 mixerSetControlDetails 함수를 호출하기 전에 이 구조체의 모든 멤버를 초기화해야 합니다.

구문

typedef struct tMIXERCONTROLDETAILS {
  DWORD  cbStruct;
  DWORD  dwControlID;
  DWORD  cChannels;
  union {
    HWND  hwndOwner;
    DWORD cMultipleItems;
  } DUMMYUNIONNAME;
  DWORD  cbDetails;
  LPVOID paDetails;
} MIXERCONTROLDETAILS, *PMIXERCONTROLDETAILS, *LPMIXERCONTROLDETAILS;

멤버

cbStruct

MIXERCONTROLDETAILS 구조체의 크기(바이트)입니다. 크기는 기본 MIXERCONTROLDETAILS 구조를 포함할 만큼 충분히 커야 합니다. mixerGetControlDetails가 반환되면 이 멤버에는 반환된 정보의 실제 크기가 포함됩니다. 반환된 정보는 요청된 크기를 초과하지 않으며 기본 MIXERCONTROLDETAILS 구조체보다 작습니다.

dwControlID

속성을 얻거나 설정할 컨트롤 식별자입니다.

cChannels

컨트롤 속성을 얻거나 설정할 채널 수입니다. 다음 값이 정의됩니다.

애플리케이션은 1과 오디오 라인의 채널 수 사이에 속하는 값을 지정할 수 없습니다. 예를 들어 4개 채널 줄에 2 또는 3을 지정하는 것은 유효하지 않습니다. 이 멤버는 비사용자 컨트롤 형식의 경우 0일 수 없습니다.

이 멤버는 비사용자 컨트롤 형식의 경우 0일 수 없습니다.

DUMMYUNIONNAME

DUMMYUNIONNAME.hwndOwner

믹서 컨트롤에 대한 사용자 지정 대화 상자를 소유하는 창에 대한 핸들입니다. 이 멤버는 mixerSetControlDetails 함수에 MIXER_SETCONTROLDETAILSF_CUSTOM 플래그를 지정할 때 사용됩니다.

DUMMYUNIONNAME.cMultipleItems

속성을 얻거나 설정할 채널당 여러 항목 수입니다. 다음 값이 정의됩니다.

MIXERCONTROL_CONTROLTYPE_CUSTOM 플래그 없이 MIXERCONTROL_CONTROLTYPE_CUSTOM 컨트롤을 사용하는 경우 이 멤버에 대해 0을 지정합니다.

애플리케이션은 MIXERCONTROL_CONTROLF_MULTIPLE 컨트롤에 대해 MIXERCONTROL 구조체의 cMultipleItems 멤버에 지정된 값 이외의 값을 지정할 수 없습니다.

cbDetails

사용 중인 다음 세부 정보 구조 중 하나의 크기(바이트)입니다.

paDetails

지정된 컨트롤의 속성을 검색하거나 설정하는 하나 이상의 구조체 배열에 대한 포인터입니다.

MIXERCONTROL_CONTROLF_MULTIPLE 컨트롤의 경우 이 버퍼의 크기는 MIXERCONTROLDETAILS 구조체의 cChannels, cMultipleItems 및 cbDetails 멤버의 곱이어야 합니다. MIXERCONTROL_CONTROLF_MULTIPLE 형식 이외의 컨트롤의 경우 이 버퍼의 크기는 MIXERCONTROLDETAILS 구조체의 cChannels 및 cbDetails 멤버의 곱입니다.

MIXERCONTROL_CONTROLF_MULTIPLE 형식 이외의 컨트롤의 경우 이 버퍼의 크기는 MIXERCONTROLDETAILS 구조체의 cChannels 및 cbDetails 멤버의 곱입니다. MIXERCONTROL_CONTROLF_MULTIPLE 형식 이외의 컨트롤의 경우 이 버퍼의 크기는 MIXERCONTROLDETAILS 구조체의 cChannels 및 cbDetails 멤버의 곱입니다.

MIXERCONTROL_CONTROLF_MULTIPLE 형식인 컨트롤의 경우 배열을 채널 주체인 2차원 배열로 처리할 수 있습니다. 즉, 왼쪽 채널에 대한 모든 여러 항목이 지정된 다음 오른쪽 채널에 대한 모든 여러 항목이 제공됩니다.

MIXERCONTROL_CONTROLF_MULTIPLE 형식 이외의 컨트롤의 경우 각 요소 인덱스는 영향을 주는 0부터 시작하는 채널과 동일합니다. 즉, paDetails[0]은 왼쪽 채널용이고 paDetails[1]은 오른쪽 채널에 대한 것입니다.

컨트롤이 MIXERCONTROL_CONTROLTYPE_CUSTOM 컨트롤인 경우 이 멤버는 MIXERCONTROL 구조체의 cbCustomData 멤버가 지정한 크기(바이트)를 포함할 만큼 충분히 큰 버퍼를 가리킵니다.

요구 사항

추가 정보

오디오 믹서 구조체

오디오 믹서

MIXERCONTROL

mixerGetControlDetails

mixerSetControlDetails