set 명령

참고

바이어스 없는 커뮤니케이션 Microsoft는 다양하고 포용적인 환경을 지원합니다. 이 문서에는 '슬레이브'라는 단어에 대한 참조가 있습니다. Microsoft의 Bias-Free 커뮤니케이션 스타일 가이드는 이를 제외 단어로 인식합니다. 이 단어는 현재 명령 내에서 사용되는 표현이므로 사용됩니다. 일관성을 위해 이 문서에는 이 단어가 포함되어 있습니다. 명령에서 이 단어를 변경하면 이 문서가 정렬되도록 수정됩니다.

set 명령은 디바이스에 대한 제어 설정을 설정합니다. CD 오디오, 디지털 비디오, MIDI 시퀀서, VCR, videodisc, 비디오 오버레이 및 파형 오디오 디바이스는 이 명령을 인식합니다.

이 명령을 보내려면 다음과 같이 lpszCommand 매개 변수가 설정된 mciSendString 함수를 호출합니다.

_stprintf_s(
  lpszCommand,
  TEXT("set %s %s %s"),
  lpszDeviceID,
  lpszSetting,
  lpszFlags
);
      

매개 변수

lpszDeviceID

MCI 디바이스의 식별자입니다. 이 식별자 또는 별칭은 디바이스가 열릴 때 할당됩니다.

lpszSetting

컨트롤 설정을 위한 플래그입니다. 다음 표에는 set 명령과 각 형식에서 사용하는 플래그를 인식하는 디바이스 유형이 나열되어 있습니다.

디바이스 유형 명령 플래그
cdaudio
  • 오디오 모두 끄기
  • 오디오 모두 켜기
  • 오디오가 중단되었습니다.
  • 오디오가 켜진 상태로
  • 오디오 바로 끄기
  • 오디오 오른쪽 켜기
  • 문이 닫혔습니다.
  • 문 열기
  • 시간 형식 밀리초
  • 시간 형식 msf
  • 시간 형식 tmsf
digitalvideo
  • 오디오 모두 끄기
  • 오디오 모두 켜기
  • 오디오가 중단되었습니다.
  • 오디오가 켜진 상태로
  • 오디오 바로 끄기
  • 오디오 오른쪽 켜기
  • 문이 닫혔습니다.
  • 문 열기
  • 파일 형식 형식
  • 정확히 을(를) 검색합니다.
  • 정확히 끄기
  • 속도 계수
  • still 파일 형식 형식
  • 시간 형식 프레임
  • 시간 형식 밀리초
  • 비디오 끄기
  • 비디오 켜기
오버레이
  • 오디오 모두 끄기
  • 오디오 모두 켜기
  • 오디오가 중단되었습니다.
  • 오디오가 켜진 상태로
  • 오디오 바로 끄기
  • 오디오 오른쪽 켜기
  • 문이 닫혔습니다.
  • 문 열기
  • 비디오 끄기
  • 비디오 켜기
sequencer
  • 오디오 모두 끄기
  • 오디오 모두 켜기
  • 오디오가 중단되었습니다.
  • 오디오가 켜진 상태로
  • 오디오 바로 끄기
  • 오디오 오른쪽 켜기
  • 문이 닫혔습니다.
  • 문 열기
  • master MIDI
  • master 없음
  • SMPTE master
  • 오프셋 시간
  • 포트 매퍼
  • 포트 없음
  • 포트 port_number
  • 슬레이브 파일
  • 슬레이브 MIDI
  • 슬레이브 없음
  • 슬레이브 SMPTE
  • tempo tempo_value
  • 시간 형식 밀리초
  • 시간 형식 SMPTE fps
  • 시간 형식 SMPTE 30 삭제
  • 시간 형식 노래 포인터
Vcr
  • 어셈블 레코드 켜기
  • 레코드 어셈블 해제
  • 오디오 모두 끄기
  • 오디오 모두 켜기
  • 오디오가 중단되었습니다.
  • 오디오가 켜진 상태로
  • 오디오 바로 끄기
  • 오디오 오른쪽 켜기
  • 클록 시간
  • 카운터 형식
  • 카운터
  • 닫힌 문
  • 문 열기
  • 인덱스 카운터
  • 인덱스 날짜
  • 인덱스 시간
  • 인덱스 시간
  • codelength 기간
  • 일시 중지 시간 제한
  • postroll 기간 -
  • duration
  • 전원 켜기
  • 전원 끄기
  • 사전 등록 기간
  • 레코드 형식 SP
  • 레코드 형식 LP
  • 레코드 형식 EP
  • 속도 계수
  • 시간 형식 프레임
  • 시간 형식 hms
  • 시간 형식 밀리초
  • 시간 형식 msf
  • 시간 형식 SMPTE fps
  • 시간 형식 SMPTE 30 삭제
  • 시간 형식 tmsf
  • 시간 모드 카운터
  • 시간 모드 검색
  • 시간 모드 시간 코드
  • 추적 플러스
  • 추적에서 빼기
  • 추적 재설정
videodisc
  • 오디오 모두 꺼져 있습니다.
  • 오디오 모두 켜기
  • 오디오가 꺼져 있습니다.
  • 오디오가 켜진 상태로
  • 오디오 바로 끄기
  • 오디오 오른쪽 켜기
  • 닫힌 문
  • 문 열기
  • 시간 형식 프레임
  • 시간 형식 hms
  • 시간 형식 밀리초
  • 시간 형식 트랙
  • 비디오 끄기
  • 비디오 켜기
waveaudio
  • 맞춤 정수
  • 모든 입력
  • 모든 출력
  • 오디오 모두 꺼져 있습니다.
  • 오디오 모두 켜기
  • 오디오가 꺼져 있습니다.
  • 오디오가 켜진 상태로
  • 오디오 바로 끄기
  • 오디오 오른쪽 켜기
  • bitspersample bit_count
  • bytespersec byte_rate
  • 채널 channel_count
  • 닫힌 문
  • 문 열기
  • 서식 태그 pcm
  • 서식 태그
  • 입력 정수
  • 출력 정수
  • samplespersec 정수
  • 시간 형식 바이트
  • 시간 형식 밀리초
  • 시간 형식 샘플

다음 표에서는 lpszSetting 매개 변수에 지정할 수 있는 플래그와 해당 의미를 나열합니다.

의미
맞춤 정수 파형 오디오 디바이스에 전달된 데이터의 시작을 기준으로 데이터 블록의 맞춤을 설정합니다. 파일은 이 형식으로 저장됩니다.
모든 입력 기록할 때 현재 형식을 지원하는 입력을 사용합니다. 이 값은 기본 설정입니다.
모든 출력 재생할 때 현재 형식을 지원하는 출력을 사용합니다. 이것이 기본값입니다.
어셈블 레코드 켜기
레코드 어셈블 해제
어셈블 모드에서 모든 트랙은 디바이스에서 정의한 대로 기록됩니다. 대부분의 VCR은 기본적으로 어셈블 모드에 있습니다.
오디오 모두 꺼져 있습니다.
오디오 모두 켜기
오디오 출력을 사용하지 않도록 설정하거나 사용하도록 설정합니다. 비디오 오버레이 디바이스, MCISEQ 시퀀서 및 MCIWAVE 파형 오디오 디바이스는 이 플래그를 지원하지 않습니다.
오디오가 꺼져 있습니다.
오디오가 켜진 상태로
오디오 바로 끄기
오디오 오른쪽 켜기
왼쪽 또는 오른쪽 오디오 채널에 대한 출력을 사용하지 않도록 설정하거나 활성화합니다. 비디오 오버레이 디바이스, MCISEQ 시퀀서 및 MCIWAVE 파형 오디오 디바이스는 이 플래그를 지원하지 않습니다.
bitspersample bit_count 재생되거나 기록된 PCM(펄스 코드 변조) 샘플당 비트 수를 설정합니다. 파일은 이 형식으로 저장됩니다.
bytespersec byte_rate 재생되거나 기록된 초당 평균 바이트 수를 설정합니다. 파일이 이 형식으로 저장됩니다.
채널 channel_count 재생 및 녹음을 위한 채널을 설정합니다. 파일이 이 형식으로 저장됩니다.
클록 시간 외부 클록의 시간을 시간으로 설정합니다 . 형식은 긴 부호 없는 정수로 지정됩니다.
카운터 형식 "카운터"상태 반환된 카운터의 시간 형식을 설정합니다. 해당 형식에 대한 자세한 내용은 set "time format" 명령을 참조하세요.
카운터 VCR 카운터를 지정된 값으로 설정합니다. 값은 현재 카운터 형식으로 지정해야 합니다. 자세한 내용은 set "counter format" 명령을 참조하세요.
문이 닫혔습니다. 가능한 경우 트레이를 철회하고 문을 닫습니다. VCR의 경우 테이프를 자동으로 로드합니다.
문 열기 가능하면 문을 열고 트레이나 테이프를 꺼내세요.
파일 형식 형식 저장 또는 캡처 명령에 사용되는 파일 형식을 지정합니다. 생략하면 기본적으로 디바이스 드라이버 정의 형식이 될 수 있습니다. 지정된 파일 형식이 현재 선택한 알고리즘 및 품질과 충돌하는 경우 파일 형식의 기본값으로 변경됩니다. 다음 파일 형식이 정의됩니다.
  • avi: AVI 형식을 지정합니다.
  • avss: AVSS 형식을 지정합니다.
  • dib: DIB 형식을 지정합니다.
  • jfif: JFIF 형식을 지정합니다.
  • jpeg: JPEG 형식을 지정합니다.
  • mpeg: MPEG 형식을 지정합니다.
  • rdib: RLE DIB 형식을 지정합니다.
  • rjpeg: RJPEG 형식을 지정합니다.
서식 태그 pcm 재생 및 녹음을 위해 형식 형식을 PCM으로 설정합니다. 파일이 이 형식으로 저장됩니다.
태그 태그 서식 지정 재생 및 녹음에 대한 형식 유형을 설정합니다. 파일이 이 형식으로 저장됩니다.
인덱스 시간 코드
인덱스 카운터
인덱스 날짜
인덱스 시간
VCR의 현재 디스플레이 화면을 설정합니다.
입력 정수 입력으로 사용되는 오디오 채널을 설정합니다.
길이 기간 VCR에서 사용자가 지정한 테이프 길이를 설정합니다. 이 길이는 상태 "length" 명령에 의해 반환되며 유효한 길이를 반환하기 위해 이 명령이 필요한 애플리케이션과의 호환성을 위해 제공됩니다.
master 미디 MIDI 시퀀서 를 동기화 원본으로 설정합니다. 동기화 데이터는 MIDI 형식으로 전송됩니다. MCISEQ 시퀀서가 이 플래그를 지원하지 않습니다.
master 없음 MIDI 시퀀서가 동기화 데이터를 보내지 못하도록 합니다. MCISEQ 시퀀서가 이 플래그를 지원하지 않습니다.
master smpte MIDI 시퀀서 를 동기화 원본으로 설정합니다. 동기화 데이터는 SMPTE(영화 및 텔레비전 엔지니어 협회) 형식으로 전송됩니다. MCISEQ 시퀀서가 이 플래그를 지원하지 않습니다.
오프셋 시간 SMPTE 오프셋 시간을 설정합니다. 오프셋은 SMPTE 기반 시퀀스의 시작 시간입니다. 시간은hh로 표현됩니다. mm: ss: ff, 여기서 hh는 시간, mm은 분, ss는 초, ff는 프레임입니다.
출력 정수 출력으로 사용되는 오디오 채널을 설정합니다.
일시 중지 시간 제한 일시 중지 명령의 최대 기간을 밀리초 단위로 설정합니다. 시간 제한 값이 0이면 시간 제한이 발생하지 않음을 나타냅니다.
postroll 기간 중지 또는 일시 중지 명령이 실행될 때 VCR 전송을 브레이크하는 데 필요한 길이를 현재 시간 형식으로 설정합니다.
포트 매퍼 MIDI 매퍼를 MIDI 메시지를 받는 포트로 설정합니다. MIDI 매퍼 또는 필요한 포트가 다른 애플리케이션에서 사용되는 경우 이 명령은 실패합니다.
포트 없음 MIDI 메시지 전송을 사용하지 않도록 설정합니다. 이 명령은 MIDI 포트도 닫습니다.
포트 port_number MIDI 메시지를 수신하는 MIDI 포트를 설정합니다. 열려는 포트가 다른 애플리케이션에서 사용되는 경우 이 명령은 실패합니다.
전원 켜기
전원 끄기
디바이스 전원을 켜거나 끕니다.
사전 등록 기간 VCR 출력을 안정화하는 데 필요한 길이를 현재 시간 형식으로 설정합니다.
레코드 형식 SP
레코드 형식 LP
레코드 형식 EP
VCR의 녹음/녹화 모드를 표준 플레이의 경우 SP, 확장 플레이의 경우 EP 또는 장기 플레이의 경우 LP로 설정합니다. 이러한 값은 VHS에만 해당되지 않습니다. 다른 테이프 형식의 세 가지 적절한 모드에 매핑됩니다. 예를 들어 SP는 가장 빠르고 높은 품질의 기록에 매핑합니다.
samplespersec 정수 재생 및 녹음에 대한 샘플 속도를 설정합니다. 파일이 이 형식으로 저장됩니다.
정확히 을(를) 검색합니다.
정확히 끄기
두 가지 검색 모드 중 하나를 선택합니다. "seek exactly on"을 사용하면 seek는 항상 지정된 프레임으로 이동합니다. "seek exactly off"를 사용하면 seek가 지정된 프레임 이전에 가장 가까운 키 프레임으로 이동합니다.
슬레이브 파일 파일 데이터를 동기화 원본으로 사용하도록 MIDI 시퀀서 설정 이 값은 기본 설정입니다.
슬레이브 미디 동기화 원본에 들어오는 MIDI 데이터를 사용하도록 MIDI 시퀀서 설정 시퀀서가 MIDI 형식으로 동기화 데이터를 인식합니다. MCISEQ 시퀀서가 이 플래그를 지원하지 않습니다.
슬레이브 없음 동기화를 무시하도록 MIDI 시퀀서 설정
슬레이브 smpte 동기화 원본에 들어오는 MIDI 데이터를 사용하도록 MIDI 시퀀서 설정 Sequencer는 동기화 데이터를 SMPTE 형식으로 인식합니다. MCISEQ 시퀀서가 이 플래그를 지원하지 않습니다.
속도 계수 작업 영역에서 비디오 및 오디오 재생의 상대적 속도를 설정합니다. 요소는 명목 프레임 속도와 원하는 프레임 속도 사이의 비율이며, 여기서 명목 프레임 속도는 1000으로 지정됩니다. (500의 속도는 절반 정상 속도, 2000은 두 배 정상 속도 등입니다.) 속도를 0으로 설정하면 프레임을 놓지 않고 오디오 없이 비디오를 최대한 빠르게 재생할 수 있습니다.
still 파일 형식 형식 캡처 명령에 사용되는 파일 형식을 지정합니다.
tempo tempo_value 현재 시간 형식에 따라 시퀀스의 tempo를 설정합니다. PPQN 기반 파일의 경우 tempo_value 분당 비트로 해석됩니다. SMPTE 기반 파일의 경우 tempo_value 초당 프레임으로 해석됩니다.
시간 형식 바이트 PCM 파일 형식에서 시간 형식을 바이트로 설정합니다. 모든 위치 정보는 이 명령 다음에 바이트로 지정됩니다.
시간 형식 프레임 시간 형식을 프레임으로 설정합니다. 위치 값을 사용하는 모든 명령은 프레임을 가정합니다. 디바이스가 열리면 프레임이 기본 모드입니다. CAV 형식을 사용하여 videodiscs에서 지원됩니다.
시간 형식 hms 시간 형식을 시간, 분 및 초로 설정합니다. 위치 값을 사용하는 모든 명령은 HMS를 가정합니다. HMS는 CLV 비디오 디스크의 기본 형식입니다. HMS 값을 hh:mm:ss로 지정합니다. 여기서 hh는 시간, mm은 분, ss는 초입니다. 필드와 다음 필드가 모두 0이면 필드를 생략할 수 있습니다. 예를 들어 3, 3:0 및 3:0:0은 모두 3시간을 표현하는 유효한 방법입니다.
시간 형식 밀리초 시간 형식을 밀리초로 설정합니다. 위치 값을 사용하는 모든 명령은 밀리초를 가정합니다. 밀리초를 "ms"로 축약할 수 있습니다. 시퀀서 디바이스의 경우 시퀀스 파일은 기본 형식을 PPQN 또는 SMPTE로 설정합니다. 비디오 오버레이 디바이스는 이 플래그를 지원하지 않습니다.
시간 형식 msf 시간 형식을 분, 초 및 프레임으로 설정합니다. 위치 값을 사용하는 모든 명령은 MSF(CD 오디오의 기본 형식)를 가정합니다. MSF 값을 mm:ss:ff로 지정합니다. 여기서 mm은 분, ss는 초, ff는 프레임입니다. 필드와 다음 필드가 모두 0이면 필드를 생략할 수 있습니다. 예를 들어 3, 3:0 및 3:0:0은 3분을 표현하는 유효한 방법입니다.
MSF 필드에는 다음과 같은 최대 값이 있습니다.
  • 분 99
  • 초 59
  • 프레임 74
시간 형식 샘플 시간 형식을 샘플로 설정합니다. 모든 위치 정보는 이 명령에 따라 샘플로 지정됩니다.
시간 형식 smpte 24
시간 형식 smpte 25
시간 형식 smpte 30
시간 형식을 SMPTE 프레임 속도로 설정합니다. VCR의 경우 시간 형식을 hh:mm:ss:ff로 설정합니다. 여기서 법적 값은 00:00:00~23:59:59:xx이고 xx는 플래그에 지정된 숫자 24, 25 또는 30에 지정된 초당 프레임보다 1보다 작습니다. 입력에서 콜론(:) 는 구성 요소를 분리하는 데 필요합니다. 최소 단위는 00인 경우 생략할 수 있습니다. 예를 들어 02:00은 02:00:00:00과 같습니다. 위치 값을 사용하는 모든 명령은 SMPTE 형식을 가정합니다.
시퀀스 파일은 기본 형식을 PPQN 또는 SMPTE로 설정합니다.
시간 형식 smpte 30 drop 시간 형식을 SMPTE 30 드롭 프레임 속도로 설정합니다. VCR의 경우 특정 시간 코드 위치가 형식에서 삭제되어 각 프레임에 대해 기록된 시간 코드 위치(NTSC 프레임 속도 29.97fps)가 실시간(30fps)에 해당한다는 점을 제외하고 SMPTE 30과 동일합니다. 삭제되는 시간 코드 위치는 기록된 콘텐츠의 10분마다 처음 9개에 대해 1분마다 2개입니다. 예를 들어 01:04:59:29에서 다음 시간 코드 위치는 01:05:00:00이 아니라 01:05:00:02가 됩니다. 위치 값을 사용하는 모든 명령은 SMPTE 형식을 가정합니다.
시퀀스 파일은 기본 형식을 PPQN 또는 SMPTE로 설정합니다.
시간 형식 노래 포인터 시간 형식을 노래 포인터(16번째 노트)로 설정합니다. 위치 값을 사용하는 모든 명령은 노래 포인터 단위를 가정합니다. 이 플래그는 PPQN 분할 형식 시퀀스에만 유효합니다.
시간 형식 tmsf 시간 형식을 트랙, 분, 초 및 프레임으로 설정합니다. 위치 값을 사용하는 모든 명령은 TMSF를 가정합니다. TMSF 값을 tt:mm:ss:ff로 지정합니다. 여기서 tt는 트랙, mm은 분, ss는 초, ff는 프레임입니다. 필드와 다음 필드가 모두 0이면 필드를 생략할 수 있습니다. 예를 들어 3, 3:0, 3:0:0 및 3:0:0:0은 모두 트랙 3을 표현하는 유효한 방법입니다.
TMSF 필드에는 다음과 같은 최대 값이 있습니다.
  • 트랙 99
  • 분 90
  • 초 59
  • 프레임 74
시간 형식 트랙 위치 형식을 트랙으로 설정합니다. 위치 값을 사용하는 모든 명령은 트랙을 가정합니다.
시간 모드 카운터 VCR 카운터를 사용하도록 위치 정보 모드를 설정합니다.
시간 모드 검색 테이프의 시간 코드 정보 검색에 따라 위치 정보 모드를 설정합니다. 시간 코드 정보가 검색되면 시간 유형이 "timecode"로 설정됩니다. 그렇지 않으면 시간 형식이 "counter"로 설정됩니다. "검색"은 특수 모드입니다. 드라이버를 열 때마다 새 테이프가 삽입되거나 "시간 모드" 명령이 실행되면 드라이버는 테이프에서 사용할 수 있는 현재 시간 모드를 확인하고 "시간 유형"을 "시간 코드" 또는 "카운터"로 설정합니다. "시간 유형"이 설정되면 위의 조건 중 하나가 다시 발생할 때까지 드라이버가 변경되지 않습니다.
시간 모드 시간 코드 테이프에서 "시간 코드" 정보를 사용하도록 위치 정보 모드를 설정합니다.
추적 플러스
추적에서 빼기
추적 재설정
비디오 테이프 전송 속도를 미세하게 조정합니다. VCR에서 시끄러운 그림을 가져올 때 "추적" 플래그를 사용합니다. "추적 플러스"는 전송 속도를 높입니다. "추적 빼기"는 전송 속도를 줄입니다. "추적 재설정"은 추적 조정을 0으로 반환합니다.
비디오 끄기 비디오 출력을 사용하지 않도록 설정합니다.
비디오 켜기 비디오 출력을 사용하도록 설정합니다.

lpszFlags

"wait", "notify" 또는 둘 다일 수 있습니다. 디지털 비디오 및 VCR 디바이스의 경우 "테스트"를 지정할 수도 있습니다. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.

반환 값

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

설명

데이터를 저장할 파일이 만들어지면 파형 오디오 데이터의 여러 속성이 정의됩니다. 이러한 속성은 파일 내에서 데이터를 구성하는 방법을 설명하며 기록이 시작되면 변경할 수 없습니다. 다음 목록에서는 이러한 속성을 식별합니다.

  • 정렬(alignment)
  • bitspersample
  • bytespersec
  • channels
  • 서식 태그
  • samplespersec

예제

다음 명령은 시간 형식을 밀리초로 설정하고 파형 오디오 형식을 8비트, 모노, 11kHz로 설정합니다.

set mysound time format ms bitspersample 8 channels 1 samplespersec 11025

요구 사항

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

추가 정보

Mci

MCI 명령 문자열

캡처

pause

저장

stop