stop

stop

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

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

stop device stopflag flag

인수

device

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

stopflag

디지털 비디오 디바이스에서만, 이하의 파라미터를 지정할 수 있습니다.

파라미터	의미	디바이스
hold	스크린상의 정지화면을 재묘화 하기 위해서 필요한 자원이 해방되지 않게 합니다.예를 들면 윈도우가 이동되었을 때 등에, 재묘화에 사용할 수 있도록(듯이), frame buffer는 이용 가능한 그대로 남겨집니다.	digitalvideo

flag

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

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

반환값

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

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

해설

CD오디오 디바이스에서는, 재생이 정지되고, 현재의 트럭 포지션이 0 에 리셋트 됩니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후