CAPTUREPARMS 구조체(vfw.h)

아티클
08/27/2023

CAPTUREPARMS 구조에는 스트리밍 비디오 캡처 프로세스를 제어하는 매개 변수가 포함되어 있습니다. 이 구조는 캡처 속도, 캡처하는 동안 사용할 버퍼 수 및 캡처가 종료되는 방법에 영향을 주는 매개 변수를 가져와서 설정하는 데 사용됩니다.

구문

typedef struct tagCaptureParms {
  DWORD dwRequestMicroSecPerFrame;
  BOOL  fMakeUserHitOKToCapture;
  UINT  wPercentDropForError;
  BOOL  fYield;
  DWORD dwIndexSize;
  UINT  wChunkGranularity;
  BOOL  fUsingDOSMemory;
  UINT  wNumVideoRequested;
  BOOL  fCaptureAudio;
  UINT  wNumAudioRequested;
  UINT  vKeyAbort;
  BOOL  fAbortLeftMouse;
  BOOL  fAbortRightMouse;
  BOOL  fLimitEnabled;
  UINT  wTimeLimit;
  BOOL  fMCIControl;
  BOOL  fStepMCIDevice;
  DWORD dwMCIStartTime;
  DWORD dwMCIStopTime;
  BOOL  fStepCaptureAt2x;
  UINT  wStepCaptureAverageFrames;
  DWORD dwAudioBufferSize;
  BOOL  fDisableWriteCache;
  UINT  AVStreamMaster;
} CAPTUREPARMS, *PCAPTUREPARMS, *LPCAPTUREPARMS;

멤버

dwRequestMicroSecPerFrame

요청된 프레임 속도(마이크로초) 기본값은 초당 15프레임에 해당하는 66667입니다.

fMakeUserHitOKToCapture

사용자가 시작한 캡처 플래그입니다. 이 멤버가 TRUE이면 AVICap에 캡처를 시작하라는 대화 상자가 표시됩니다. 기본값은 FALSE입니다.

wPercentDropForError

캡처하는 동안 삭제된 프레임의 최대 허용 비율입니다. 값은 0에서 100 사이입니다. 기본값은 10입니다.

fYield

Yield 플래그입니다. 이 멤버가 TRUE이면 캡처 창은 단계 및 스트리밍 캡처를 수행하기 위해 별도의 백그라운드 스레드를 생성합니다. 기본값은 FALSE입니다.

이 플래그를 설정하는 애플리케이션은 캡처가 진행 중인 동안 애플리케이션의 컨트롤을 사용하지 않도록 설정되지 않으므로 잠재적인 재진입 문제를 처리해야 합니다.

dwIndexSize

AVI 파일의 최대 인덱스 항목 수입니다. 값 범위는 1800에서 324,000까지입니다. 0으로 설정하면 기본값인 34,952(32K 프레임 및 비례 오디오 버퍼 수)가 사용됩니다.

파형 오디오 데이터의 각 비디오 프레임 또는 버퍼는 하나의 인덱스 항목을 사용합니다. 이 항목의 값은 캡처할 수 있는 프레임 또는 오디오 버퍼 수에 대한 제한을 설정합니다.

wChunkGranularity

AVI 파일의 논리적 블록 크기(바이트)입니다. 값 0은 현재 섹터 크기가 세분성으로 사용됨을 나타냅니다.

fUsingDOSMemory

Win32 애플리케이션에서는 사용되지 않습니다.

wNumVideoRequested

할당할 최대 비디오 버퍼 수입니다. 버퍼를 배치할 메모리 영역은 fUsingDOSMemory로 지정됩니다. 메모리를 사용할 수 없는 경우 할당된 실제 버퍼 수가 더 적을 수 있습니다.

fCaptureAudio

오디오 플래그를 캡처합니다. 이 멤버가 TRUE이면 스트리밍 캡처 중에 오디오가 캡처됩니다. 오디오 하드웨어가 설치된 경우 기본값입니다.

wNumAudioRequested

할당할 최대 오디오 버퍼 수입니다. 최대 버퍼 수는 10개입니다.

vKeyAbort

스트리밍 캡처를 종료하는 데 사용되는 가상 키 코드입니다. 기본값은 VK_ESCAPE. 캡처 세션을 중단할 수 있는 키 입력을 지정하기 전에 RegisterHotKey 함수를 호출해야 합니다.

논리 OR 연산자를 ctrl(0x8000) 및 shift(0x4000)에 대한 키 코드와 사용하여 CTRL 및 Shift 키 입력을 포함하는 키 코드를 결합할 수 있습니다.

fAbortLeftMouse

마우스 왼쪽 단추에 대한 플래그를 중단합니다. 이 멤버가 TRUE이면 왼쪽 마우스 단추를 누르면 스트리밍 캡처가 중지됩니다. 기본값은 TRUE입니다.

fAbortRightMouse

마우스 오른쪽 단추에 대한 플래그를 중단합니다. 이 멤버가 TRUE이면 오른쪽 마우스 단추를 누르면 스트리밍 캡처가 중지됩니다. 기본값은 TRUE입니다.

fLimitEnabled

시간 제한 사용 플래그입니다. 이 멤버가 TRUE이면 wTimeLimit 의 초 수가 경과한 후 스트리밍 캡처가 중지됩니다. 기본값은 FALSE입니다.

wTimeLimit

캡처 시간 제한(초)입니다. 이 매개 변수는 fLimitEnabled가TRUE인 경우에만 사용됩니다.

fMCIControl

MCI 디바이스 캡처 플래그입니다. 이 멤버가 TRUE이면 AVICap은 스트리밍 캡처 중에 MCI 호환 비디오 원본을 제어합니다. MCI 호환 비디오 원본에는 VCR 및 레이저 디스크가 포함됩니다.

fStepMCIDevice

MCI 디바이스 단계 캡처 플래그입니다. 이 멤버가 TRUE이면 MCI 디바이스를 비디오 원본으로 사용하는 단계 캡처가 사용하도록 설정됩니다. FALSE이면 MCI 디바이스를 사용한 실시간 캡처가 사용하도록 설정됩니다. (fMCIControl이 FALSE이면 이 멤버는 무시됩니다.)

dwMCIStartTime

캡처 시퀀스에 대한 MCI 디바이스의 시작 위치(밀리초)입니다. (fMCIControl이 FALSE이면 이 멤버는 무시됩니다.)

dwMCIStopTime

캡처 시퀀스에 대한 MCI 디바이스의 위치(밀리초)를 중지합니다. 콘텐츠의 이 위치에 도달하면 캡처가 종료되고 MCI 디바이스가 중지됩니다. (fMCIControl이 FALSE이면 이 멤버는 무시됩니다.)

fStepCaptureAt2x

이중 해상도 단계 캡처 플래그입니다. 이 멤버가 TRUE이면 캡처 하드웨어가 지정된 해상도의 두 배로 캡처됩니다. 높이와 너비에 대한 해상도가 두 배로 증가합니다.

하드웨어가 하드웨어 기반 삭제를 지원하지 않고 RGB 형식으로 캡처하는 경우 이 옵션을 사용하도록 설정합니다.

wStepCaptureAverageFrames

평균 샘플을 기반으로 프레임을 만들 때 프레임이 샘플링되는 횟수입니다. 평균 수의 일반적인 값은 5입니다.

dwAudioBufferSize

오디오 버퍼 크기입니다. 기본값 0을 사용하는 경우 각 버퍼의 크기는 오디오의 최대 0.5초 또는 10K 바이트가 됩니다.

fDisableWriteCache

Win32 애플리케이션에서는 사용되지 않습니다.

AVStreamMaster

AVI 파일을 작성할 때 오디오 스트림이 클록을 제어하는지 여부를 나타냅니다. 이 멤버가 AVSTREAMMASTER_AUDIO 설정되면 오디오 스트림은 master 스트림으로 간주되고 비디오 스트림 기간은 오디오 기간과 일치하도록 강제됩니다. 이 멤버가 AVSTREAMMASTER_NONE 설정되면 오디오 및 비디오 스트림의 기간이 다를 수 있습니다.

설명

WM_CAP_GET_SEQUENCE_SETUP 메시지 또는 capCaptureGetSetup 매크로는 현재 캡처 매개 변수를 검색하는 데 사용됩니다. WM_CAP_SET_SEQUENCE_SETUP 메시지 또는 capCaptureSetSetup 매크로는 캡처 매개 변수를 설정하는 데 사용됩니다.

요구 사항

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