update 명령

update 명령은 현재 프레임을 지정된 DC(디바이스 컨텍스트)에 다시 칠합니다. 디지털 비디오 디바이스는 이 명령을 인식합니다.

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

_stprintf_s(
  lpszCommand, 
  TEXT("update %s %s %s"), 
  lpszDeviceID, 
  lpszHDC, 
  lpszFlags
);

매개 변수

lpszDeviceID

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

lpszHDC

DC의 핸들입니다. 다음 표에서는 업데이트 명령을 인식하는 디바이스 유형과 각 형식에서 사용하는 플래그를 나열합니다.

값	의미	의미
digitalvideo	hdc hdc hdchdc at rect	그림 hdc hdc

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

값	의미
hdc hdc	그릴 DC의 핸들을 지정합니다.
사각형의 hdc hdc	클라이언트 사각형을 기준으로 클리핑 사각형을 지정합니다.
그림 hdc hdc	애플리케이션이 DC용 WM_PAINT 메시지를 수신할 때 DC를 그립니다.

DC의 핸들을 지정하려면 문자열 "hdc"와 핸들의 ASCII 표현을 사용합니다. 사각형은X1 Y1 X2 Y2로 지정됩니다. 좌표X1 Y1은 사각형의 왼쪽 위 모서리를 지정하고 좌표X2 Y2는 너비와 높이를 지정합니다.

lpszFlags

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

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

다음 명령은 "동영상" 디바이스에서 사용하는 전체 디스플레이 창을 업데이트합니다. 숫자 203은 BeginPaint 함수에서 가져온 DC에 대한 핸들입니다.

update movie hdc 203

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