save 명령

저장 명령은 MCI 파일을 저장합니다. 비디오 오버레이 및 파형 오디오 디바이스는 이 명령을 인식합니다. 디지털 비디오 디바이스 및 MIDI 시퀀서도 이 명령을 인식하지만 MCIAVI 및 MCISEQ 드라이버는 이를 지원하지 않습니다.

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

_stprintf_s(
  lpszCommand, 
  TEXT("save %s %s %s"), 
  lpszDeviceID, 
  lpszFilename, 
  lpszFlags
); 

매개 변수

lpszDeviceID

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

lpszFilename

저장되는 파일의 이름을 지정하고 필요에 따라 저장 작업을 수정하는 추가 플래그를 지정하는 플래그입니다. 다음 표에서는 저장 명령과 각 형식에서 사용하는 플래그를 인식하는 디바이스 유형을 나열합니다.

값	의미	의미
digitalvideo	사각형에서 중단	filenamekeepreserve
오버레이	직사각형에서	filename
sequencer	filename
waveaudio	filename

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

값	의미
abort	진행 중인 저장 작업을 중지합니다. 사용하는 경우 이 항목이 유일한 항목이어야 합니다.
직사각형에서	프레임 버퍼 원본을 기준으로 사각형을 지정합니다. 사각형은 X1 Y1 X2 Y2로 지정됩니다. 좌표 X1 Y1 은 왼쪽 위 모서리를 지정하고 좌표 X2 Y2 는 너비와 높이를 지정합니다. 디지털 비디오 디바이스의 경우 캡처 명령은 프레임 버퍼의 콘텐츠를 캡처하는 데 사용됩니다.
filename	데이터 파일에 할당할 파일 이름을 지정합니다. 경로를 지정하지 않으면 파일이 디스크 및 명시적 또는 암시적 예약 명령에 이전에 지정된 디렉터리에 배치됩니다. 예약이 실행되지 않은 경우 기본 드라이브 및 디렉터리는 애플리케이션의 작업과 연결된 드라이브와 디렉터리입니다. 경로가 지정된 경우 디바이스는 명시적 또는 암시적 예약으로 지정된 디스크 드라이브에 있어야 할 수 있습니다. 이 플래그는 필수입니다.
keepreserve	원래 예약 명령에서 남은 사용되지 않는 디스크 공간이 할당 취소되지 않도록 지정합니다.

lpszFlags

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

반환 값

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

설명

"새" 디바이스 식별자를 사용하여 디바이스를 연 경우 파일 이름 변수가 필요합니다.

예제

다음 명령은 전체 비디오 버퍼를 VCAPFILE이라는 파일에 저장합니다. Tga.

save vboard c:\vcap\vcapfile.tga

요구 사항

추가 정보

Mci

MCI 명령 문자열

캡처

예약