(vfw.h) CAPSTATUS 結構

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