ACM_OPEN 메시지

AVI 클립을 열고 애니메이션 컨트롤에 첫 번째 프레임을 표시합니다. 이 메시지를 명시적으로 보내거나 Animate_Open 또는 Animate_OpenEx 매크로를 사용할 수 있습니다. 이 메시지의 유니코드 버전인 ACM_OPENW를 사용하는 것이 좋습니다.

매개 변수

wParam

버전 4.71 이상. 리소스를 로드해야 하는 모듈에 대한 인스턴스 핸들입니다. 이 값을 NULL로 설정하면 컨트롤이 창을 만드는 데 사용되는 HINSTANCE 값을 사용합니다. 창이 DLL에 의해 만들어진 경우 wParam의 기본값은 DLL을 호출하는 애플리케이션이 아니라 DLL의 HINSTANCE 값입니다.

lParam

AVI 파일의 경로 또는 AVI 리소스의 이름을 포함하는 버퍼에 대한 포인터입니다. 또는 이 매개 변수는 LOWORD의 AVI 리소스 식별자와 HIWORD의 0으로 구성될 수 있습니다. 이 값을 만들려면 MAKEINTRESOURCE 매크로를 사용합니다. 컨트롤은 CreateWindow 함수, Animate_Create 매크로 또는 컨트롤을 만든 대화 상자 만들기 함수에 전달된 인스턴스 핸들이 지정한 모듈에서 AVI 리소스를 로드합니다. 버전 4.71 이상에서는 리소스가 wParam에 지정된 모듈에서 로드됩니다. AVI 리소스는 "AVI" 형식이어야 합니다. 이 매개 변수가 NULL이면 시스템은 지정된 애니메이션 컨트롤에 대해 이전에 열린 AVI 파일(있는 경우)을 닫습니다.

반환 값

성공하면 0이 아닌 값을 반환하고 그렇지 않으면 0을 반환합니다.

설명

lpszName에서 지정한 AVI 파일 또는 리소스는 오디오를 포함하지 않아야 합니다.

이 메시지의 유니코드 버전인 ACM_OPENW를 사용하는 것이 좋습니다.

자동 AVI 클립만 열 수 있습니다. ACM_OPEN 및 Animate_Open은 lParam이 소리가 포함된 AVI 클립을 지정하는 경우 실패합니다.

Animate_Close를 사용하여 지정된 애니메이션 컨트롤에 대해 이전에 열린 AVI 파일 또는 AVI 리소스를 닫을 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003[데스크톱 앱만 해당]
헤더	Commctrl.h
유니코드 및 ANSI 이름	ACM_OPENW(유니코드) 및 ACM_OPENA(ANSI)