restore 명령

restore 명령은 파일의 스틸 이미지를 프레임 버퍼로 복사합니다. 캡처 명령의 반대입니다. 디지털 비디오 디바이스는 이 명령을 인식합니다.

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

_stprintf_s(
  lpszCommand, 
  TEXT("restore %s %s %s"), 
  lpszDeviceID, 
  lpszRestore, 
  lpszFlags
);

매개 변수

lpszDeviceID

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

lpszRestore

다음 플래그 중 하나 이상.

값	의미
직사각형에서	프레임 버퍼 원본을 기준으로 사각형을 지정합니다. 사각형은 X1 Y1 X2 Y2로 지정됩니다. 좌표 X1 Y1 은 왼쪽 위 모서리를 지정하고 좌표 X2 Y2 는 너비와 높이를 지정합니다. 이 플래그를 사용하지 않으면 이미지가 프레임 버퍼의 왼쪽 위 모서리에 복사됩니다.
파일 이름에서	회수할 이미지 파일 이름을 지정합니다. 이 플래그는 필수입니다.

lpszFlags

"wait", "notify", "test" 또는 이들 조합일 수 있습니다. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.

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

디바이스는 다양한 이미지 형식을 인식할 수 있습니다. Windows 디바이스 독립적 비트맵은 항상 인식됩니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]