play 명령

  • 아티클

재생 명령이 디바이스 재생을 시작합니다. CD 오디오, 디지털 비디오, MIDI 시퀀서, videodisc, VCR 및 파형 오디오 디바이스는 이 명령을 인식합니다.

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

_stprintf_s(
  lpszCommand, 
  TEXT("play %s %s %s"), 
  lpszDeviceID, 
  lpszPlayFlags, 
  lpszFlags
);

매개 변수

lpszDeviceID

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

lpszPlayFlags

디바이스를 재생하기 위한 플래그입니다. 다음 표에는 재생 명령을 인식하는 디바이스 유형과 각 형식에서 사용하는 플래그가 나열되어 있습니다.

값 의미 의미
cdaudio 위치에서 위치로
digitalvideo 부터 전체화면 반복 역 방향 위치창
sequencer 위치에서 위치로
Vcr 위치에서역방향으로 위치를 검사합니다 .
videodisc 빠른 위치역방향 검색 위치까지의 느린 속도 정수
waveaudio 위치에서 위치로

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

값 의미
시간 디바이스가 이 명령을 수행하기 시작해야 하는 경우 또는 cued 명령이 시작될 때 디바이스가 cued된 경우를 나타냅니다. 자세한 내용은 cue 명령을 참조하세요.
fast 디바이스가 평소보다 빠르게 재생되어야 했음을 나타냅니다. videodisc 플레이어의 정확한 속도를 확인하려면 상태 명령의 "속도" 플래그를 사용합니다. 속도를 보다 정확하게 지정하려면 이 명령의 "속도" 플래그를 사용합니다.
위치에서 재생의 시작 위치를 지정합니다. "from" 플래그를 지정하지 않으면 현재 위치에서 재생이 시작됩니다. cdaudio 디바이스의 경우 "from" 위치가 디스크의 끝 위치보다 크거나 "from" 위치가 "to" 위치보다 크면 드라이버가 오류를 반환합니다. videodisc 디바이스의 경우 기본 위치는 CAV 디스크의 경우 프레임에 있고 CLV 디스크의 경우 시간, 분 및 초 단위입니다.
전체 화면 전체 화면 표시를 사용되도록 지정합니다. 압축된 파일을 재생할 때만 이 플래그를 사용합니다. (압축되지 않은 파일은 전체 화면으로 재생되지 않습니다.)
repeat 콘텐츠의 끝에 도달하면 재생이 다시 시작되도록 지정합니다.
reverse 재생 방향이 뒤로 가 되도록 지정합니다. "역방향" 플래그를 사용하여 끝 위치를 지정할 수 없습니다. videodiscs의 경우 "scan"은 CAV 형식에만 적용됩니다.
검색 비디오를 사용하지 않도록 설정하지 않고 최대한 빨리 재생합니다(오디오를 사용하지 않도록 설정할 수 있지만). videodiscs의 경우 "scan"은 CAV 형식에만 적용됩니다.
slow 천천히 재생됩니다. videodisc 플레이어의 정확한 속도를 확인하려면 상태 명령의 "속도" 플래그를 사용합니다. 속도를 보다 정확하게 지정하려면 이 명령의 "속도" 플래그를 사용합니다. videodiscs의 경우 "slow"는 CAV 형식에만 적용됩니다.
속도 정수 지정된 속도로 초당 프레임 단위로 비디오 디스크를 재생합니다. 이 플래그는 CAV 디스크에만 적용됩니다.
위치로 재생의 끝 위치를 지정합니다. "to" 플래그를 지정하지 않으면 콘텐츠의 끝에서 재생이 중지됩니다. cdaudio 디바이스의 경우 "to" 위치가 디스크의 끝 위치보다 크면 드라이버에서 오류를 반환합니다. videodisc 디바이스의 경우 기본 위치는 CAV 디스크의 경우 프레임에 있고 CLV 디스크의 경우 시간, 분 및 초 단위입니다.
시간 범위 재생 중 디바이스 instance 연결된 창을 사용하도록 지정합니다. 이 값은 기본 설정입니다.

lpszFlags

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

반환 값

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

설명

위치 값을 사용하는 명령을 실행하기 전에 set 명령을 사용하여 원하는 시간 형식을 설정 해야 합니다. 이 명령은 설정된 "속도" 명령으로 설정된 대로 현재 속도로 재생되기 시작합니다. "역방향" 플래그를 지정하거나 "to" 플래그가 "from" 플래그보다 작은 값으로 지정되면 방향이 역방향입니다. "from" 플래그를 지정하지 않으면 현재 위치에서 재생이 시작됩니다. "to" 및 "reverse" 플래그는 함께 사용할 수 없습니다.

예제

다음 명령은 위치 1000부터 위치 2000까지 "mysound" 디바이스를 재생하여 재생이 완료되면 알림 메시지를 보냅니다.

play mysound from 1000 to 2000 notify

요구 사항

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

추가 정보

Mci

MCI 명령 문자열

큐

set