CBaseControlVideo 類別

[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

CBaseControlVideo類別會實作IBasicVideo介面，並控制一般視訊視窗的視訊屬性。 一般而言， CBaseControlVideo 物件是影片轉譯器，可將視訊繪製到顯示器上的視窗。

許多 CBaseControlVideo 成員函式只需要將視訊轉譯器連線到篩選圖形。 如果未連線，成員函式會傳回 VFW_E_NOT_CONNECTED。 在視訊轉譯器上設定的屬性會在連續連線與中斷連線之間保存。 所有應用程式都應該在啟動簡報之前，先重設轉譯器屬性。

使用視訊時，應用程式可以選取要使用的部分影片。 這個部分是 CBaseControlVideo 物件控制項的來源矩形。 CBaseControlVideo 可讓您的應用程式設定及擷取來源矩形。 CBaseControlVideo使用的所有矩形採用寬度和高度值，而不是右和下值。 未設定來源矩形時，來源矩形的屬性會傳回完整的原生視訊大小。

受保護的資料成員	Description
m_pFilter	擁有媒體篩選的指標。
m_pInterfaceLock	外部定義的重要區段。
m_pPin	控制連線的媒體類型。
成員函數	Description
CBaseControlVideo	建構 CBaseControlVideo 物件。
CopyImage	建立視訊影像的記憶體複本。
GetImageSize	擷取視訊影像大小資訊。
SetControlVideoPin	設定這個物件應該同步處理的針腳。
可覆寫的成員函式	Description
CheckSourceRect	判斷來源矩形是否有效。
CheckTargetRect	判斷目標矩形是否有效。
GetSourceRect	擷取目前來源視訊矩形， (純虛擬) 。
GetStaticImage	傳回記憶體緩衝區中的目前映射， (純虛擬) 。
GetTargetRect	擷取目前的目標視訊矩形 (純虛擬) 。
GetVideoFormat	擷取包含視訊格式的 VIDEOINFOHEADER 結構。
IsDefaultSourceRect	判斷轉譯器是否使用預設來源矩形， (純虛擬) 。
IsDefaultTargetRect	判斷轉譯器是否使用預設目標矩形， (純虛擬) 。
OnUpdateRectangles	來源或目標矩形變更時呼叫。
OnVideoSizeChange	將EC_VIDEO_SIZE_CHANGED傳遞至應用程式。
SetDefaultSourceRect	設定純虛擬) (預設來源視訊矩形。
SetDefaultTargetRect	(純虛擬) 設定預設目標視訊矩形。
SetSourceRect	設定目前的來源視訊矩形， (純虛擬) 。
SetTargetRect	設定目前的目標矩形 (純虛擬) 。
IBasicVideo 方法	Description
get_AvgTimePerFrame	擷取每個畫面格的大約平均時間。
get_BitErrorRate	擷取大約位錯誤率。
get_BitRate	擷取影片的大約位元速率。
GetCurrentImage	擷取目前影像的記憶體轉譯。
get_DestinationHeight	擷取目前目的地矩形的高度。
get_DestinationLeft	擷取目前目的地矩形的左座標。
GetDestinationPosition	擷取目前的目的地位置。
get_DestinationTop	擷取目前目的地矩形的頂端座標。
get_DestinationWidth	擷取目前目的地矩形的寬度。
get_SourceHeight	擷取目前來源矩形的高度。
get_SourceLeft	擷取目前來源矩形的左座標。
GetSourcePosition	擷取目前的來源位置。
get_SourceTop	擷取目前來源矩形的頂端座標。
get_SourceWidth	擷取目前來源矩形的寬度。
get_VideoHeight	擷取原生視訊高度。
GetVideoPaletteEntries	擷取視訊的調色盤專案範圍。
GetVideoSize	擷取原生視訊的寬度和高度。
get_VideoWidth	擷取原生視訊寬度。
IsUsingDefaultDestination	判斷轉譯器是否使用預設目的地視窗。
IsUsingDefaultSource	判斷轉譯器是否使用預設來源視窗。
put_DestinationHeight	設定目的矩形的高度。
put_DestinationLeft	設定目的矩形的左座標。
put_DestinationTop	設定目的地矩形的頂端座標。
put_DestinationWidth	設定目的矩形的寬度。
put_SourceHeight	設定來源矩形的高度。
put_SourceLeft	設定來源矩形的左座標。
put_SourceTop	設定來源矩形的頂端座標。
put_SourceWidth	設定來源矩形的寬度。
SetDefaultDestinationPosition	再次設定預設目的地位置。
SetDefaultSourcePosition	再次設定預設來源位置。
SetDestinationPosition	設定目的矩形位置。
SetSourcePosition	設定來源矩形位置。

 

另請參閱

DirectShow 基類