play (디바이스의 재생)

play

play 커멘드는, 디바이스의 재생(연주)을 개시합니다.CD오디오, 디지털 비디오,MIDI시퀀서,VCR, 웨이브 형식 오디오의 각 디바이스가 이 커멘드를 인식합니다.

이 커멘드를 송신하려면 , mciSendString 함수를 사용합니다.

play device playflag flag

인수

device

MCI디바이스의 식별자를 지정합니다.이 식별명 또는 앨리어스(alias)는, 디바이스가 오픈될 때 할당할 수 있습니다.

playflag

디바이스 재생을 위한 플래그를 기술합니다.이하로 지정 가능한 파라미터와 파라미터를 인식할 수 있는 디바이스 타입을 나타냅니다.

파라미터	의미	디바이스
at time	언제 이 커멘드를 실행하는지, 또는, cue 커멘드에 의해 벌써 재생의 준비가 이루어지고 있는 경우에는, 언제 그 커멘드를 실행하는지를 지정합니다.	vcr
fast	디바이스가 표준보다 빠르게 재생하는 것을 나타냅니다. videodisc 플레이어로의 엄밀한 속도를 판정하려면 , status 커멘드의“speed”플래그를 사용합니다.정확한 속도를 지정하려면 , 이 커멘드의“speed”플래그를 사용합니다.	videodisc
from position	재생 개시 위치를 지정합니다.이 플래그가 지정되지 않는 경우에는, 재생은 현재의 위치로부터 개시됩니다. cdaudio 디바이스에서는, 개시 위치로서 디스크의 말미보다 뒤를 지정했을 경우에는, 에러가 돌아갑니다. videodisc 디바이스에서는, 디폴트 포지션은CAV디스크에서는 프레임수,CLV디스크에서는 시：분：초로 지정합니다.	cdaudio digitalvideo sequencer vcr videodisc waveaudio
fullscreen	풀 스크린 표시를 사용할지를 지정합니다.이 플래그는 압축 형식의 파일에게만 사용해 주세요.	digitalvideo
repeat	끝까지 연주되었을 때에 다시 재생을 개시하도록(듯이) 지정합니다.	digitalvideo
reverse	재생 방향을 역방향(윳돈?듯이) 지정합니다.이 플래그와 함께 말미 위치를 지정해 연주를 개시시킬 수 없습니다.	digitalvideo vcr videodisc
scan	비디오를 볼 수 있는 상태로 가능한 한 빠르게 재생합니다.다만, 오디오는 재생되지 않습니다. videodisc 그럼,CAV포맷의 경우만 적용됩니다.	vcr videodisc
slow	슬로우 재생합니다. videodisc 플레이어로의 엄밀한 속도를 판정하려면 , status 커멘드의“speed”플래그를 사용합니다.정확한 속도를 지정하려면 , 이 커멘드의“speed”플래그를 사용합니다. videodisc 그럼,CAV포맷의 경우만 적용됩니다.	videodisc
speed integer	videodisc (을)를,FPS(frames per second)(으)로 지정된 속도로 재생합니다.이 플래그는CAV포맷의 경우만 적용됩니다.	videodisc
type device_type	재생의 종료 위치를 지정합니다.이 플래그가 지정되지 않는 경우에는, 재생은 내용의 말미로 정지됩니다. cdaudio 디바이스에서는, 재생 종료 위치로서 디스크의 말미보다 뒤를 지정했을 경우에는, 에러가 돌아갑니다. videodisc 디바이스에서는, 디폴트 포지션은CAV디스크에서는 프레임수,CLV디스크에서는 시：분：초로 지정합니다.	cdaudio digitalvideo sequencer vcr videodisc waveaudio
window	디바이스 인스턴스에 관련지을 수 있고 있는 윈도우를 사용해 재생하도록(듯이) 지정합니다.이 플래그는 디폴트 설정입니다.	digitalvideo

flag

아무것도 기술하지 않는지, “wait”, “notify”의 언젠가, 또는 이 양쪽 모두를 기술합니다.디지털 비디오 및VCR디바이스에서는, “test”(을)를 기술할 수도 있습니다.

파라미터	의미
wait	어플리케이션에 제어를 돌려주기 전에, 요구된 지시를 완료할 때까지 대기합니다.
notify	디바이스가 작업을 완료했을 때에, 윈도우에 MM_MCINOTIFY 메세지를 포스트합니다.
test	디바이스가 커멘드를 실행할 수 있을지를 판정합니다.커멘드는 실제로 실행되지 않습니다.디바이스가 커멘드를 처리할 수 없는 경우에는 에러가 돌아갑니다.디지털 비디오 및VCR디바이스에서만 지정할 수 있습니다.

반환값

성공하면 0 하지만 돌아갑니다.

실패하면 에러 코드가 돌아갑니다.

해설

위치를 지정해 커멘드를 송신하기 전에, set 커멘드를 사용해 타임 포맷(시간의 표현 형식)을 지정해 두어야 합니다.

재생은 set 커멘드의“speed”플래그로 지정되어 있는 속도로 개시됩니다.

“reverse”플래그가 지정되어 있는지, 재생 개시 위치가 재생 종료 위치보다 뒤로 지정되어 있는 경우에는, 재생 방향이 역방향이 됩니다.

“from”플래그가 지정되지 않는 경우에는, 경향 포지션(현재 위치)으로부터 재생됩니다.

“to”플래그와“reverse”플래그를 동시에 지정할 수 없습니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후