MCIWndCreateA 함수(vfw.h)

  • 아티클

MCIWndCreate 함수는 MCIWnd 창 클래스를 등록하고 MCI 서비스를 사용하기 위한 MCIWnd 창을 만듭니다. MCIWndCreate 는 MCI 디바이스 또는 파일(예: AVI 파일)을 열고 MCIWnd 창과 연결할 수도 있습니다.

구문

HWND VFWAPIV MCIWndCreateA(
  HWND      hwndParent,
  HINSTANCE hInstance,
  DWORD     dwStyle,
  LPCSTR    szFile
);

매개 변수

hwndParent

부모 창에 대한 핸들입니다.

hInstance

MCIWnd 창과 연결할 모듈 instance 대한 핸들입니다.

dwStyle

창 스타일을 정의하는 플래그입니다. CreateWindowEx 함수와 함께 사용되는 창 스타일을 지정하는 것 외에도 MCIWnd 창에서 사용할 다음 스타일을 지정할 수 있습니다.

값 의미
MCIWNDF_NOAUTOSIZEWINDOW 이미지 크기가 변경될 때 MCIWnd 창의 크기는 변경되지 않습니다.
MCIWNDF_NOAUTOSIZEMOVIE MCIWnd 창 크기가 변경될 때 대상 사각형의 크기는 변경되지 않습니다.
MCIWNDF_NOERRORDLG 사용자에게 MCI 오류 표시를 금지합니다.
MCIWNDF_NOMENU 도구 모음의 보기에서 메뉴 단추를 숨기고 사용자가 팝업 메뉴에 액세스하지 못하도록 합니다.
MCIWNDF_NOOPEN MCIWnd 메뉴에서 열기 및 닫기 명령을 숨기고 사용자가 팝업 메뉴에서 이러한 선택 항목에 액세스하지 못하도록 합니다.
MCIWNDF_NOPLAYBAR 도구 모음을 보기에서 숨기고 사용자가 도구 모음에 액세스하는 것을 금지합니다.
MCIWNDF_NOTIFYANSI 디바이스 모드 변경 내용을 부모 창에 알릴 때 MCIWnd에서 유니코드 문자열 대신 ANSI 문자열을 사용하도록 합니다. 이 플래그는 MCIWNDF_NOTIFYMODE 함께 사용됩니다.
MCIWNDF_NOTIFYMODE 디바이스가 작동 모드를 변경할 때마다 MCIWnd가 MCIWNDM_NOTIFYMODE 메시지로 부모 창에 알립니다. 이 메시지의 lParam 매개 변수는 MCI_MODE_STOP 같은 새 모드를 식별합니다.
MCIWNDF_NOTIFYPOS MCIWnd가 콘텐츠 내의 재생 또는 레코드 위치 변경이 발생할 때마다 부모 창에 MCIWNDM_NOTIFYPOS 메시지를 알립니다. 이 메시지의 lParam 매개 변수에는 콘텐츠의 새 위치가 포함됩니다.
MCIWNDF_NOTIFYMEDIA MCIWnd가 새 디바이스를 사용하거나 데이터 파일을 열거나 닫을 때마다 MCIWNDM_NOTIFYMEDIA 메시지로 부모 창에 알립니다. 이 메시지의 lParam 매개 변수에는 새 파일 이름에 대한 포인터가 포함되어 있습니다.
MCIWNDF_NOTIFYSIZE MCIWnd 창 크기가 변경되면 MCIWnd가 부모 창에 알리도록 합니다.
MCIWNDF_NOTIFYERROR MCI 오류가 발생할 때 MCIWnd가 부모 창에 알리도록 합니다.
MCIWNDF_NOTIFYALL 모든 MCIWNDF 창 알림 스타일을 사용하도록 합니다.
MCIWNDF_RECORD MCI 디바이스에 기록 기능이 있는 경우 도구 모음에 레코드 단추를 추가하고 메뉴에 새 파일 명령을 추가합니다.
MCIWNDF_SHOWALL 모든 MCIWNDF_SHOW 스타일을 사용하도록 합니다.
MCIWNDF_SHOWMODE 창 제목 표시줄에 MCI 디바이스의 현재 모드를 표시합니다. 디바이스 모드 목록은 MCIWndGetMode 매크로를 참조하세요.
MCIWNDF_SHOWNAME MCIWnd 창 제목 표시줄에 열려 있는 MCI 디바이스 또는 데이터 파일의 이름을 표시합니다.
MCIWNDF_SHOWPOS 창 제목 표시줄에서 MCI 디바이스의 콘텐츠 내에서 현재 위치를 표시합니다.

szFile

열 MCI 디바이스 또는 데이터 파일의 이름을 나타내는 Null로 끝나는 문자열입니다.

반환 값

성공하거나 0이면 MCI 창에 핸들을 반환합니다.

설명

자식 창의 기본 창 스타일은 WS_CHILD, WS_BORDER 및 WS_VISIBLE. MCIWndCreate 는 부모 창의 NULL 이 아닌 핸들이 지정된 경우 자식 창을 가정합니다.

부모 창의 기본 창 스타일은 WS_OVERLAPPEDWINDOW WS_VISIBLE. MCIWndCreate 는 부모 창의 NULL 핸들이 지정된 경우 부모 창을 가정합니다.

MCIWnd 매크로의 창 핸들에 대해 이 함수에서 반환된 창 핸들을 사용합니다. 애플리케이션에서 이 함수를 사용하는 경우 MCIWndRegisterClass 함수를 사용할 필요가 없습니다.

참고

vfw.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 MCIWndCreate를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 vfw.h
라이브러리 Vfw32.lib
DLL Msvfw32.dll

추가 정보

MCIWNDM_NOTIFYMEDIA

MCIWNDM_NOTIFYMODE

MCIWNDM_NOTIFYPOS

MCIWndGetMode

MCIWndRegisterClass