Previous | Contents | Next

3.2.3 IBandiCapture::Start

동영상의 캡처를 시작합니다.

• 정의

HRESULT Start(LPCWSTR pwszFilePath, HWND hParentWnd, INT nCaptureMode, LONG_PTR lpParam);

• 파라메터

  LPCWSTR pwszFilePath

  [in] 캡처된 데이터가 저장될 파일 경로명. 파일의 확장자 까지 정확히 경로를 지정하여야 합니다.

  HWND hParentWnd

  [in] 캡처 도중 이벤트 발생시 이벤트를 받을 윈도우 핸들을 지정합니다. 아직 이 값은 사용되지 않습니다.

  INT nCaptureMode

  [in] 캡처모드를 지정합니다. 사용 가능한 값은 다음과 같습니다.

  BCAP_MODE_GDI

  GDI를 이용하여 화면을 캡처 합니다. lpParam 에는 윈도우 핸들(HWND)를 파라메터로 사용해야 합니다.

  BCAP_MODE_D3D9

  D3D9 화면을 캡처합니다. lpParam에는 IDirect3DDevice9* 를 파라메터로 사용해야 합니다. 저장될 영상의 크기가 화면의 크기와 다를경우 CPU를 이용해서 영상의 크기를 조절합니다.

  이 캡처모드는 화면의 크기가 변경될 경우(예: 전체화면 전환) 캡처가 자동 종료됩니다.

  BCAP_MODE_D3D9_SCALE

  D3D9 화면을 캡처합니다. lpParam에는 IDirect3DDevice9* 를 파라메터로 사용해야 합니다. 대상 영상의 크기가 화면크기와 다를경우 IDirect3DDevice9::StretchRect()를 이용해서 영상의 크기를 조절합니다.

  이 캡처모드는 크기조절에 의한 CPU 사용률을 절감시킬 수 있으며, 화면의 크기가 변경되어도 캡처가 종료되지 않습니다.

  BCAP_MODE_D3D9_SWAPCHAIN

  D3D9 화면을 캡처합니다. lpParam에는 IDirect3DSwapChain9* 를 파라메터로 사용해야 합니다. 저대상 영상의 크기가 화면크기와 다를경우 IDirect3DDevice9::StretchRect()를 이용해서 영상의 크기를 조절합니다.

  이 캡처모드는 크기조절에 의한 CPU 사용률을 절감시킬 수 있으며, 화면의 크기가 변경되어도 캡처가 종료되지 않습니다.

  BCAP_MODE_D3D8

  D3D8 화면을 캡처합니다. lpParam에는 IDirect3DDevice8* 를 파라메터로 사용해야 합니다.

  이 캡처모드는 화면의 크기가 변경될 경우(예: 전체화면 전환) 캡처가 자동 종료됩니다.

  BCAP_MODE_D3D10

  D3D10 화면을 캡처합니다. lpParam에는 IDXGISwapChain* 를 파라메터로 사용해야 합니다.

  이 캡처모드는 화면의 크기가 변경될 경우(예: 전체화면 전환) 캡처가 자동 종료됩니다.

  BCAP_MODE_GL

  OpenGL 화면을 캡처합니다. lpParam에 NULL 값을 파라메터로 사용해야 합니다.

  이 캡처모드는 화면의 크기가 변경될 경우(예: 전체화면 전환) 캡처가 자동 종료됩니다.

  BCAP_MODE_DDRAW7

  DDRAW7 화면을 캡처합니다. lpParam에는 DDRAW7의 백버퍼(IDirectDrawSurface7*)를 파라메터로 사용해야 합니다.

  이 캡처모드는 화면의 크기가 변경될 경우(예: 전체화면 전환) 캡처가 자동 종료됩니다.

  BCAP_MODE_D3D11

  D3D11 화면을 캡처합니다. lpParam에는 IDXGISwapChain* 를 파라메터로 사용해야 합니다.

  이 캡처모드는 화면의 크기가 변경될 경우(예: 전체화면 전환) 캡처가 자동 종료됩니다.

  LONG_PTR lpParam

  [in] 캡처 데이타 파라메터로 캡처모드(nCaptureMode)에 따라 다른 값을 설정합니다.

  BCAP_MODE_GDI : 캡처 대상이 되는 윈도우 핸들(HWND)

  BCAP_MODE_D3D9 : 캡처 대상이 되는 영역의 Direct3D9 인터페이스 포인터 (IDirect3DDevice9*)

  BCAP_MODE_D3D9_SCALE : 캡처 대상이 되는 영역의 Direct3D9 Device 인터페이스 포인터 (IDirect3DDevice9*)

  BCAP_MODE_D3D9_SWAPCHAIN : 캡처 대상이 되는 영역의 Direct3D9 SwapChain 인터페이스 포인터 (IDirect3DSwapChain9*)

  BCAP_MODE_D3D8 : 캡처 대상이 되는 영역의 Direct3D8 인터페이스 포인터 (IDirect3DDevice8*)

  BCAP_MODE_D3D10 : 캡처 대상이 되는 영역의 SwapChain 인터페이스 포인터 (IDXGISwapChain*)

  BCAP_MODE_GL : 파라메터를 설정하지 않음 (NULL)

  BCAP_MODE_DDRAW7 : 캡처 대상이 되는 영역의 DDRAW7 백버퍼 인터페이스 포인터 (IDirectDrawSurface7*)

  BCAP_MODE_D3D11 : 캡처 대상이 되는 영역의 SwapChain 인터페이스 포인터 (IDXGISwapChain*)

• 리턴값

  BC_OK_ONLY_VIDEO

  비디오 스트림만 생성되었습니다.

  BC_OK_ONLY_AUDIO

  오디오 스트림만 생성되었습니다.

  BCERR_INVALIDARG

  잘못된 파라메터값이 전달되었습니다.

  BCERR_VIDEO_CAPTURE

  비디오 캡처 모듈에 오류가 발생하였습니다.

  BCERR_AUDIO_CAPTURE

  오디오 캡처 모듈에 오류가 발생하였습니다.

• 주의사항
  1. 캡처 모드(nCaptureMode)에 따라 lpParam 값이 달라지며, 잘못된 lpParam 값을 사용할 경우 오류(Crash error)가 발생할 수 있습니다.
  2. 대상 경로 지정시, 프로그램이 설치된 폴더(e.g. c:\Program Files\OOOOOO\Capture\)를 대상 경로로 지정하지 마시기 바랍니다. Windows Vista 의 경우 UAC를 통한 Admin 권한 상승이 없을경우 Program Files 폴더에 파일을 쓸수가 없습니다.