VFW: 取得與設定錄影參數

攝影機錄影期間, 必須針對需求設定相關攝影參數, 這些參數在 vfw.h 之中, 宣告一個資料型態來儲存這些參數。

typedef struct tagCaptureParms {
　DWORD dwRequestMicroSecPerFrame;
　　　　　　　　　　 // Requested capture rate
　BOOL fMakeUserHitOKToCapture; // Show "Hit OK to cap" dlg?
　UINT wPercentDropForError; // Give error msg if > (10%)
　BOOL fYield; // Capture via background task?
　DWORD dwIndexSize; // Max index size in frames (32K)
　UINT wChunkGranularity; // Junk chunk granularity (2K)
　BOOL fUsingDOSMemory; // Use DOS buffers?
　UINT wNumVideoRequested; // # video buffers, If 0, autocalc
　BOOL fCaptureAudio; // Capture audio?
　UINT wNumAudioRequested; // # audio buffers, If 0, autocalc
　UINT vKeyAbort; // Virtual key causing abort
　BOOL fAbortLeftMouse; // Abort on left mouse?
　BOOL fAbortRightMouse; // Abort on right mouse?
　BOOL fLimitEnabled; // Use wTimeLimit?
　UINT wTimeLimit; // Seconds to capture
　BOOL fMCIControl; // Use MCI video source?
　BOOL fStepMCIDevice; // Step MCI device?
　DWORD dwMCIStartTime; // Time to start in MS
　DWORD dwMCIStopTime; // Time to stop in MS
　BOOL fStepCaptureAt2x; // Perform spatial averaging 2x
　UINT wStepCaptureAverageFrames;
　　　　　　　　　　// Temporal average n Frames
　DWORD dwAudioBufferSize; // Size of audio bufs (0 = default)
　BOOL fDisableWriteCache; // Attempt to disable write cache
　UINT AVStreamMaster; // Which stream controls length?
} CAPTUREPARMS, *PCAPTUREPARMS, FAR *LPCAPTUREPARMS;

因此, 我們在程式中可以如下宣告一個變數 s,

tagCaptureParms s;

然後, 我們就可以透過 &s 當作為呼叫 VFW SDK 相關函數的參數, 了解目前視訊系統的攝影參數設定為何? 一般來說, 一些我們比較常用到的攝影參數為:

• 指定視訊畫面的擷取速率
• 指定分派影像緩衝區數目
• 選擇是否'擷取聲音
• 指定視訊串流擷取時間長短
• 指定擷取時間是否使用 MCI 裝置
• 指定鍵盤或滑鼠控制來終止擷取
  

在 VFW SDK 中, 透過 capCaptureGetSetup 可以知道目前的錄影參數的設定為何?

The capCaptureGetSetup macro retrieves the current settings of the streaming capture parameters.

BOOL capCaptureGetSetup(
　hwnd,
　s,
　wSize
　);

Parameters
hwnd　Handle of a capture window.
s　Address of a CAPTUREPARMS structure.
wSize　Size, in bytes, of the structure referenced by s.

Return Values
Returns TRUE if successful or FALSE otherwise.

Remarks
For information about the parameters used to control streaming capture, see the CAPTUREPARMS structure.

知道了錄影參數的設定情形後, 我們也可以透過 capCaptureSetSetup 來改變錄影參數的設定:

The capCaptureSetSetup macro sets the configuration parameters used with streaming capture.

BOOL capCaptureSetSetup(
　hwnd,
　s,
　wSize
　);

Parameters
hwnd　Handle of a capture window.
s　Address of a CAPTUREPARMS structure.
wSize　Size, in bytes, of the structure referenced by s.

Return Values
Returns TRUE if successful or FALSE otherwise.

Remarks
For information about the parameters used to control streaming capture, see the CAPTUREPARMS structure.

延伸閱讀: C++ Builder's Help 中的 CAPTUREPARMS structure