MCI_SETAUDIO 명령

  • 아티클

MCI_SETAUDIO 명령은 오디오 재생 및 캡처와 관련된 값을 설정합니다. 디지털 비디오 및 VCR 디바이스는 이 명령을 인식합니다.

이 명령을 보내려면 다음 매개 변수를 사용하여 mciSendCommand 함수를 호출합니다.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SETAUDIO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpSetAudio
);

매개 변수

wDeviceID

명령 메시지를 받을 MCI 디바이스의 디바이스 식별자입니다.

dwFlags

MCI_NOTIFY, MCI_WAIT 또는 MCI_TEST. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.

lpSetAudio

MCI_GENERIC_PARMS 구조체에 대한 포인터입니다. (확장 명령 집합이 있는 디바이스는 이 구조를 디바이스별 구조로 대체할 수 있습니다.)

반환 값

성공하면 0을 반환하고, 그렇지 않으면 오류를 반환합니다.

설명

digitalvideo 디바이스 유형에는 다음 플래그가 적용됩니다.

MCI_DGV_SETAUDIO_ALG

lpSetAudio로 식별된 구조체의 lpstrAlgorithm 멤버에는 오디오 압축 알고리즘의 이름을 포함하는 버퍼의 주소가 포함되어 있습니다. 압축 알고리즘은 후속 MCI_RESERVE 또는 MCI_RECORD 명령에 사용됩니다. 사용 가능한 알고리즘은 디바이스에 따라 다릅니다. 알고리즘이 현재 파일 형식과 호환되지 않는 경우 파일 형식이 알고리즘의 기본 형식으로 변경됩니다.

MCI_DGV_SETAUDIO_CLOCKTIME

지정된 시간은 밀리초 단위이며 MCI_DGV_SETAUDIO_OVER 사용할 때 절대 시간입니다. (이번에는 작업 영역의 재생 단계가 아닙니다.)

MCI_DGV_SETAUDIO_INPUT

입력 신호에 영향을 미치고 기록되는 내용을 수정할 수 있도록 베이스, 고음 또는 볼륨 플래그를 수정합니다. 가능한 경우 입력을 모니터링할 때 기본값입니다.

MCI_DGV_SETAUDIO_ITEM

오디오 상수는 lpSetAudio로 식별된 구조체의 dwItem 멤버에 지정됩니다. 상수는 설정되는 값을 식별합니다. 다음 상수가 정의됩니다.

MCI_DGV_SETAUDIO_AVGBYTESPERSEC

평균 바이트 수는 lpSetAudio로 식별된 구조체의 dwValue 멤버에 지정됩니다. 이 값은 PCM(펄스 코드 변조) 및 ADPCM(적응 차등 펄스 코드 변조) 형식으로 재생 또는 녹음하기 위한 초당 평균 바이트 수를 설정합니다. 파일은 이 형식으로 저장됩니다.

MCI_DGV_SETAUDIO_BASS

오디오 주파수가 낮은 수준은 lpSetAudio로 식별된 구조체의 dwValue 멤버에 있는 요소로 지정됩니다.

MCI_DGV_SETAUDIO_BITSPERSAMPLE

샘플당 비트 수는 lpSetAudio로 식별된 구조체의 dwValue 멤버에 지정됩니다. 이 값은 PCM 형식으로 재생되거나 기록된 샘플당 비트 수를 설정합니다. 파일은 이 형식으로 저장됩니다.

MCI_DGV_SETAUDIO_BLOCKALIGN

데이터 블록 맞춤은 lpSetAudio로 식별된 구조체의 dwValue 멤버에 지정됩니다. 이 값은 입력 파형 데이터의 시작을 기준으로 데이터 블록의 맞춤을 설정합니다.

MCI_DGV_SETAUDIO_SAMPLESPERSEC

샘플 속도는 lpSetAudio로 식별된 구조체의 dwValue 멤버에 지정됩니다. 이 값은 PCM 및 ADPCM 알고리즘을 사용하여 재생 및 녹음하기 위한 샘플 속도를 설정합니다. 파일은 이 형식으로 저장됩니다.

MCI_DGV_SETAUDIO_SOURCE

오디오 입력 소스를 지정하는 상수는 lpSetAudio로 식별된 구조체의 dwValue 멤버에 포함됩니다. 다음 상수는 오디오 입력 원본에 대해 정의됩니다.

MCI_DGV_SETAUDIO_SOURCE_AVERAGE

왼쪽 및 오른쪽 오디오 채널의 평균입니다.

MCI_DGV_SETAUDIO_SOURCE_LEFT

왼쪽 오디오 채널.

MCI_DGV_SETAUDIO_SOURCE_RIGHT

오른쪽 오디오 채널.

MCI_DGV_SETAUDIO_SOURCE_STEREO

스테레오.

MCI_DGV_SETAUDIO_STREAM

오디오 스트림은 lpSetAudio로 식별된 구조체의 dwValue 멤버에 지정됩니다. 정수 값은 작업 영역에서 재생된 오디오 스트림을 지정합니다. 스트림을 지정하지 않으면 물리적으로 인터리빙된 첫 번째 오디오 스트림이 재생됩니다.

MCI_DGV_SETAUDIO_TREBLE

오디오 고주파 수준은 lpSetAudio로 식별된 구조체의 dwValue 멤버에 있는 요소로 지정됩니다.

MCI_DGV_SETAUDIO_VOLUME

하나 또는 두 오디오 채널의 오디오 수준은 lpSetAudio로 식별된 구조체의 dwValue 멤버에 있는 요소로 지정됩니다. 왼쪽 및 오른쪽 볼륨이 다른 값으로 설정된 경우 왼쪽에서 오른쪽 볼륨의 비율은 거의 변경되지 않습니다.

MCI_DGV_SETAUDIO_LEFT

MCI_SET_ON 함께 사용할 때 왼쪽 오디오 채널을 사용하도록 설정합니다. MCI_SET_OFF 함께 사용할 때 왼쪽 오디오 채널을 사용하지 않도록 설정합니다. 이 플래그를 MCI_DGV_SETAUDIO_VALUE 및 MCI_DGV_SETAUDIO_VOLUME 조합하여 사용하면 왼쪽 오디오 채널의 볼륨이 설정됩니다. 이 플래그를 MCI_DGV_SETAUDIO_SOURCE 사용하는 경우 왼쪽 오디오 채널을 오디오 입력 디지타이저의 원본으로 지정합니다.

MCI_DGV_SETAUDIO_OVER

전환 길이 매개 변수는 lpSetAudio로 식별된 구조체의 dwOver 멤버에 포함됩니다. 길이 값은 요소를 사용하는 변경을 수행하는 데 걸리는 시간(현재 시간 형식 단위)을 지정합니다. 이 플래그를 사용하지 않으면 변경 내용이 즉시 발생합니다.

MCI_DGV_SETAUDIO_QUALITY

lpSetAudio로 식별되는 구조체의 lpstrQuality 멤버에는 오디오 품질을 정의하는 버퍼의 주소가 포함되어 있습니다. 버퍼 내의 텍스트 문자열은 오디오 압축 알고리즘의 특성을 지정합니다.

MCI_DGV_SETAUDIO_ALG 플래그를 사용하여 지정된 알고리즘에 대한 품질 설명자를 선택할 수 있습니다. 이 플래그를 생략하면 현재 알고리즘이 사용됩니다.

사용 가능한 알고리즘 및 설명자 이름은 디바이스에 따라 달라집니다. 각 디바이스는 사용 가능한 알고리즘에 대한 설명서와 해당 설명자 이름에 대한 설명을 제공합니다. MCI_QUALITY 명령은 추가 설명자 이름을 정의할 수 있습니다.

MCI_DGV_SETAUDIO_RECORD

녹음/녹화에 오디오 데이터가 포함되거나 제외되는지 여부를 지정합니다. MCI_SET_ON 결합하면 오디오 데이터가 기록됩니다. MCI_SET_OFF 결합하면 오디오 데이터가 제외됩니다. 기본값에는 오디오 데이터가 포함됩니다.

MCI_DGV_SETAUDIO_RIGHT

MCI_SET_ON 함께 사용할 때 올바른 오디오 채널을 사용하도록 설정합니다. MCI_SET_OFF 사용할 때 올바른 오디오 채널을 사용하지 않도록 설정합니다. 이 플래그를 MCI_DGV_SETAUDIO_VALUE 및 MCI_DGV_SETAUDIO_VOLUME 조합하여 사용하면 올바른 오디오 채널의 볼륨이 설정됩니다.

MCI_DGV_SETAUDIO_VALUE

값은 lpSetAudio로 식별된 구조체의 dwValue 멤버에 지정됩니다. 값의 의미는 MCI_DGV_SETAUDIO_ITEM 플래그에 대해 정의된 상수로 지정됩니다.

MCI_SET_OFF

지정된 오디오 채널을 사용하지 않도록 설정합니다.

MCI_SET_ON

지정된 오디오 채널을 사용하도록 설정합니다.

MCI_SETAUDIO_OUTPUT

저음, 고음 또는 볼륨 플래그를 수정하여 재생된 신호만 수정하고 기록되는 신호는 수정하지 않습니다. 가능한 경우 입력을 모니터링할 때 기본값입니다.

디지털 비디오 디바이스의 경우 lpSetAudio 매개 변수는 MCI_DGV_SETAUDIO_PARMS 구조를 가리킵니다.

다음 추가 플래그는 vcr 디바이스 유형과 함께 사용됩니다.

MCI_VCR_SETAUDIO_RECORD

다음 플래그 중 하나와 함께 사용되는 오디오 녹음을 켜거나 끕니다.

MCI_SET_ON

오디오 녹음 을 켭니다.

MCI_SET_OFF

오디오 녹음이 꺼져 있습니다. 오디오 녹음을 끄기 전에 먼저 어셈블 녹음을 해제해야 할 수 있습니다( MCI_VCR_SET_ASSEMBLE_RECORD 플래그가 꺼진 상태에서 MCI_SET 명령을 사용).

MCI_TRACK

lpSetAudio로 식별된 구조체의 dwTrack 멤버는 명령의 영향을 받는 트랙을 지정합니다.

MCI_VCR_SETAUDIO_SOURCE

오디오 원본을 설정합니다. 이 플래그는 MCI_VCR_SETAUDIO_TO 플래그와 함께 사용해야 합니다.

MCI_VCR_SETAUDIO_MONITOR

오디오 원본 모니터를 설정합니다. 이 플래그는 MCI_VCR_SETAUDIO_TO 플래그와 함께 사용해야 합니다.

MCI_VCR_SETAUDIO_TO

lpSetAudio로 식별되는 구조체의 dwTo 멤버에는 입력 또는 모니터링되는 입력 유형을 설명하는 상수가 포함되어 있습니다. 다음 중 하나여야 합니다.

MCI_VCR_SRC_TYPE_TUNER

유형이 튜너입니다.

MCI_VCR_SRC_TYPE_LINE

유형이 선입니다.

MCI_VCR_SRC_TYPE_AUX

형식이 보조 형식입니다.

MCI_VCR_SRC_TYPE_GENERIC

제네릭 형식입니다.

MCI_VCR_SRC_TYPE_MUTE

형식이 음소거입니다. MCI_VCR_SETAUDIO_SOURCE 플래그에서만 사용할 수 있습니다.

MCI_VCR_SRC_TYPE_OUTPUT

형식이 출력입니다.

MCI_VCR_SETAUDIO_NUMBER

lpSetAudio로 식별되는 구조체의 dwNumber 멤버에는 사용할 오디오 입력(dwTo 멤버에 지정된 형식)이 포함됩니다.

VCR 디바이스의 경우 lpSetAudio 매개 변수는 MCI_VCR_SETAUDIO_PARMS 구조를 가리킵니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버
 Windows 2000 Server[데스크톱 앱만]
헤더
Mmsystem.h(Windows.h 포함)

추가 정보

Mci

MCI 명령