MCI_SEEK 명령

  • 아티클

MCI_SEEK 명령은 콘텐츠의 현재 위치를 가능한 한 빨리 변경합니다. 검색하는 동안 비디오 및 오디오 출력이 비활성화됩니다. 검색이 완료되면 디바이스가 중지됩니다. CD 오디오, 디지털 비디오, MIDI 시퀀서, VCR, videodisc 및 파형 오디오 디바이스는 이 명령을 인식합니다.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SEEK, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SEEK_PARMS) lpSeek
);

매개 변수

wDeviceID

명령 메시지를 받을 MCI 디바이스의 디바이스 식별자입니다.

dwFlags

디지털 비디오 및 VCR 디바이스의 경우 MCI_NOTIFY, MCI_WAIT 또는 MCI_TEST. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.

lpSeek

MCI_SEEK_PARMS 구조체에 대한 포인터입니다. (확장 명령 집합이 있는 디바이스는 이 구조를 디바이스별 구조로 대체할 수 있습니다.)

반환 값

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

설명

디바이스의 데이터 샘플 크기가 1 바이트보다 큰 경우(예: 파형 오디오 스테레오 데이터 사용) 이 명령은 지정된 위치가 샘플의 시작 부분과 일치하지 않을 때 가장 가까운 샘플의 시작 부분으로 이동합니다.

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

MCI_SEEK_TO_END

콘텐츠의 끝을 찾습니다.

MCI_SEEK_TO_START

콘텐츠의 시작 부분을 찾습니다.

MCI_TO

위치는 lpSeek으로 식별되는 구조체의 dwTo 멤버에 포함됩니다. 위치 값에 할당된 단위는 MCI_SET 명령의 MCI_SET_TIME_FORMAT 플래그로 지정됩니다. MCI_SEEK_TO_END 또는 MCI_SEEK_TO_START 이 플래그를 사용하지 마세요.

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

MCI_VCR_SEEK_AT

lpSeek으로 식별되는 구조체의 dwAt 멤버에는 전체 명령이 시작되는 시간이 포함됩니다.

MCI_VCR_SEEK_MARK

lpSeek으로 식별되는 구조체의 dwMark 멤버에는 검색할 번호가 매겨진 표시가 포함됩니다.

MCI_VCR_SEEK_REVERSE

검색 방향이 역방향입니다. 이는 MCI_VCR_SEEK_MARK 플래그와 함께만 사용됩니다.

VCR 디바이스의 경우 lpSeek 매개 변수는 MCI_VCR_SEEK_PARMS 구조를 가리킵니다.

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

MCI_VD_SEEK_REVERSE

검색 방향이 역방향입니다.

요구 사항

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

추가 정보

Mci

MCI 명령