MCI_RESTORE 명령

MCI_RESTORE 명령은 파일에서 프레임 버퍼로 비트맵을 복사합니다. 디지털 비디오 디바이스는 이 명령을 인식합니다. 이 명령은 MCI_CAPTURE 명령의 반대 동작을 수행합니다.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RESTORE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_RESTORE_PARMS) lpRestore
);

매개 변수

wDeviceID: 명령 메시지를 받을 MCI 디바이스의 디바이스 식별자입니다.
dwFlags: MCI_NOTIFY, MCI_WAIT 또는 MCI_TEST. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.
lpRestore: MCI_DGV_RESTORE_PARMS 구조체에 대한 포인터입니다.

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

구현은 다양한 이미지 형식을 인식할 수 있지만 Windows DIB(디바이스 독립적 비트맵)는 항상 허용됩니다.

디지털 비디오 디바이스에는 다음과 같은 추가 플래그가 적용됩니다.

MCI_DGV_RESTORE_FROM: lpRestore로 식별된 구조체의 lpstrFileName 멤버에는 원본 파일 이름이 포함된 버퍼의 주소가 포함됩니다. 파일 이름이 필요합니다.
MCI_DGV_RESTORE_AT: lpRestore로 식별된 구조체의 rc 멤버에는 유효한 사각형이 포함됩니다. 사각형은 원본을 기준으로 프레임 버퍼의 영역을 지정합니다. 첫 번째 좌표 쌍은 사각형의 왼쪽 위 모서리를 지정합니다. 두 번째 쌍은 너비와 높이를 지정합니다. 이 플래그를 지정하지 않으면 이미지가 프레임 버퍼의 왼쪽 위 모서리에 복사됩니다.

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