MCI_PLAY 명령

MCI_PLAY 명령은 디바이스에 출력 데이터 전송을 시작하도록 신호를 보냅니다. CD 오디오, 디지털 비디오, MIDI 시퀀서, videodisc, VCR 및 파형 오디오 디바이스는 이 명령을 인식합니다.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PLAY, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_PLAY_PARMS ) lpPlay
);

매개 변수

wDeviceID: 명령 메시지를 받을 MCI 디바이스의 디바이스 식별자입니다.
dwFlags: 디지털 비디오 및 VCR 디바이스의 경우 MCI_NOTIFY, MCI_WAIT 또는 MCI_TEST. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.
lpPlay: MCI_PLAY_PARMS 구조체에 대한 포인터입니다. (확장 명령 집합이 있는 디바이스는 이 구조를 디바이스별 구조로 대체할 수 있습니다.)

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

다음 추가 플래그는 MCI_PLAY 지원하는 모든 디바이스에 적용됩니다.

MCI_FROM: 시작 위치는 lpPlay로 식별된 구조체의 dwFrom 멤버에 포함됩니다. 위치 값에 할당된 단위는 MCI_SET 명령의 MCI_SET_TIME_FORMAT 플래그로 지정됩니다. MCI_FROM 지정하지 않으면 시작 위치는 기본적으로 현재 위치로 설정됩니다.
MCI_TO: 끝 위치는 lpPlay로 식별된 구조체의 dwTo 멤버에 포함됩니다. 위치 값에 할당된 단위는 MCI_SET MCI_SET_TIME_FORMAT 플래그로 지정됩니다. MCI_TO 지정하지 않으면 끝 위치는 기본적으로 미디어의 끝으로 설정됩니다.

digitalvideo 디바이스 유형에 다음과 같은 추가 플래그가 사용됩니다.

MCI_DGV_PLAY_REPEAT: 콘텐츠의 끝에 도달하면 처음부터 재생이 다시 시작됩니다.
MCI_DGV_PLAY_REVERSE: 재생은 역방향으로 발생해야 합니다.
MCI_MCIAVI_PLAY_WINDOW: 재생은 디바이스 instance 연결된 창에서 발생해야 합니다(기본값). (이 플래그는 MCIAVI와 관련이 있습니다. DRV.)
MCI_MCIAVI_PLAY_FULLSCREEN: 재생은 전체 화면 디스플레이를 사용해야 합니다. 압축된 파일 또는 8비트 파일을 재생할 때만 이 플래그를 사용합니다.

디지털 비디오 디바이스의 경우 lpPlay 는 MCI_DGV_PLAY_PARMS 구조를 가리킵니다.

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

MCI_VCR_PLAY_AT: lpPlay로 식별되는 구조체의 dwAt 멤버에는 전체 명령이 시작되거나 디바이스가 cued인 경우 디바이스가 MCI_CUE 명령에 의해 지정된 위치의 에 도달하는 시간이 포함됩니다.
MCI_VCR_PLAY_REVERSE: 재생은 역방향으로 발생해야 합니다.
MCI_VCR_PLAY_SCAN: 비디오 출력을 유지하면서 최대한 빨리 재생해야 합니다.

VCR 디바이스의 경우 lpPlay 는 MCI_VCR_PLAY_PARMS 구조를 가리킵니다.

videodisc 디바이스 유형에 다음과 같은 추가 플래그가 사용됩니다.

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