CAPSTATUS 구조체(vfw.h)

CAPSTATUS 구조체는 캡처 창의 현재 상태를 정의합니다.

구문

typedef struct tagCapStatus {
  UINT     uiImageWidth;
  UINT     uiImageHeight;
  BOOL     fLiveWindow;
  BOOL     fOverlayWindow;
  BOOL     fScale;
  POINT    ptScroll;
  BOOL     fUsingDefaultPalette;
  BOOL     fAudioHardware;
  BOOL     fCapFileExists;
  DWORD    dwCurrentVideoFrame;
  DWORD    dwCurrentVideoFramesDropped;
  DWORD    dwCurrentWaveSamples;
  DWORD    dwCurrentTimeElapsedMS;
  HPALETTE hPalCurrent;
  BOOL     fCapturingNow;
  DWORD    dwReturn;
  UINT     wNumVideoAllocated;
  UINT     wNumAudioAllocated;
} CAPSTATUS, *PCAPSTATUS, *LPCAPSTATUS;

멤버

uiImageWidth

이미지 너비(픽셀)입니다.

uiImageHeight

이미지 높이(픽셀)

fLiveWindow

라이브 창 플래그입니다. 창이 미리 보기 메서드를 사용하여 비디오를 표시하는 경우 이 멤버의 값은 TRUE 입니다.

fOverlayWindow

오버레이 창 플래그입니다. 창이 하드웨어 오버레이를 사용하여 비디오를 표시하는 경우 이 멤버의 값은 TRUE 입니다.

fScale

입력 크기 조정 플래그입니다. 미리 보기를 사용하여 비디오를 표시할 때 창이 입력 비디오를 클라이언트 영역으로 스케일링하는 경우 이 멤버의 값은 TRUE 입니다. 이 매개 변수는 오버레이를 사용하여 비디오를 표시할 때 영향을 주지 않습니다.

ptScroll

창의 클라이언트 영역 왼쪽 위 모서리에 표시되는 픽셀의 x 오프셋 및 y 오프셋입니다.

fUsingDefaultPalette

기본 색상표 플래그입니다. 캡처 드라이버가 기본 팔레트를 사용하는 경우 이 멤버의 값은 TRUE 입니다.

fAudioHardware

오디오 하드웨어 플래그입니다. 시스템에 파형 오디오 하드웨어가 설치된 경우 이 멤버의 값은 TRUE 입니다.

fCapFileExists

파일 플래그를 캡처합니다. 유효한 캡처 파일이 생성된 경우 이 멤버의 값은 TRUE 입니다.

dwCurrentVideoFrame

현재(또는 가장 최근) 스트리밍 캡처 중에 처리된 프레임 수입니다. 이 개수에는 삭제된 프레임이 포함됩니다.

dwCurrentVideoFramesDropped

현재(또는 가장 최근) 스트리밍 캡처 중에 삭제된 프레임 수입니다. 삭제된 프레임은 캡처 속도가 프레임을 파일에 저장할 수 있는 속도를 초과할 때 발생합니다. 이 경우 캡처 드라이버에는 데이터를 저장하는 데 사용할 수 있는 버퍼가 없습니다. 프레임 삭제는 이전 프레임이 삭제된 프레임 대신 표시되므로 동기화에 영향을 주지 않습니다.

dwCurrentWaveSamples

현재(또는 가장 최근) 스트리밍 캡처 중에 처리된 파형 오디오 샘플의 수입니다.

dwCurrentTimeElapsedMS

현재(또는 가장 최근) 스트리밍 캡처가 시작된 이후의 시간(밀리초)입니다.

hPalCurrent

현재 색상표에 대한 핸들입니다.

fCapturingNow

플래그 캡처. 캡처가 진행 중인 경우 이 멤버의 값은 TRUE 입니다.

dwReturn

오류 반환 값입니다. 애플리케이션에서 오류 콜백 함수를 지원하지 않는 경우 이 멤버를 사용합니다.

wNumVideoAllocated

할당된 비디오 버퍼 수입니다. 이 값은 CAPTUREPARMS 구조체의 wNumVideoRequested 멤버에 지정된 숫자보다 작을 수 있습니다.

wNumAudioAllocated

할당된 오디오 버퍼 수입니다. 이 값은 CAPTUREPARMS 구조체의 wNumAudioRequested 멤버에 지정된 수보다 작을 수 있습니다.

설명

다양한 메시지에 대한 응답으로 캡처 창의 상태가 변경되므로 애플리케이션은 메뉴 항목을 사용하도록 설정하거나, 캡처 창의 실제 상태를 결정하거나, 비디오 형식 대화 상자를 호출해야 할 때마다 이 구조의 정보를 업데이트해야 합니다. 스트리밍 캡처 중에 애플리케이션이 생성되는 경우 이 구조는 dwCurrentVideoFrame, dwCurrentVideoFramesDropped, dwCurrentWaveSamples 및 dwCurrentTimeElapsedMS 멤버에서 캡처 진행률을 반환합니다. WM_CAP_GET_STATUS 메시지 또는 capGetStatus 매크로를 사용하여 이 구조체의 내용을 업데이트합니다.

요구 사항

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

추가 정보

CAPTUREPARMS

비디오 캡처

비디오 캡처 구조

WM_CAP_GET_STATUS