(control.h) IBasicVideo 介面
[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式代碼，以使用新的 API。]
介面會 IBasicVideo 設定視訊屬性，例如目的地和來源矩形。 影片 轉譯器 篩選和視訊混合轉譯器篩選會實作此介面，但介面會透過篩選圖形管理員向應用程式公開。 應用程式應該一律從篩選圖形管理員擷取此介面。
IBasicVideo介面會操作與視訊影像相關聯的下列矩形：
- 來源矩形是顯示的原始影像部分。
- 目的矩形是接收來源矩形的視訊視窗部分。
- 視 訊 矩形是原始的視訊影像。
影片轉譯器上設定的屬性會在連續連接與中斷連線之間持續存在。
錯誤碼：如果視訊轉譯器篩選未連接到另一個篩選，所有方法都會傳回錯誤碼VFW_E_NOT_CONNECTED。 對於 Filter Graph Manager 的實作，如果圖表不包含視訊轉譯器篩選，則所有方法都會傳回E_NOINTERFACE。 請注意，即使圖形不包含視訊轉譯器，篩選圖形管理員也會公開介面，因此應用程式可以在建置圖形之前查詢介面。
繼承
IBasicVideo 介面繼承自 IDispatch 介面。 IBasicVideo 也有下列類型的成員：
方法
IBasicVideo 介面具有這些方法。
| IBasicVideo：：get_AvgTimePerFrame get_AvgTimePerFrame方法會擷取連續畫面之間的平均時間。 |
| IBasicVideo：：get_BitErrorRate get_BitErrorRate 方法會擷取視訊數據流的近似位錯誤率。 |
| IBasicVideo：：get_BitRate get_BitRate 方法會擷取視訊串流的近似比特率。 |
| IBasicVideo：：get_DestinationHeight get_DestinationHeight 方法會擷取目的矩形的高度。 |
| IBasicVideo：：get_DestinationLeft get_DestinationLeft 方法會擷取目的矩形的 X 座標。 |
| IBasicVideo：：get_DestinationTop get_DestinationTop 方法會擷取目的矩形的 Y 座標。 |
| IBasicVideo：：get_DestinationWidth get_DestinationWidth 方法會擷取目的矩形的寬度。 |
| IBasicVideo：：get_SourceHeight get_SourceHeight 方法會擷取來源矩形的高度。 |
| IBasicVideo：：get_SourceLeft get_SourceLeft 方法會擷取來源矩形的 X 座標。 |
| IBasicVideo：：get_SourceTop get_SourceTop 方法會擷取來源矩形的 Y 座標。 |
| IBasicVideo：：get_SourceWidth get_SourceWidth 方法會擷取來源矩形的寬度。 |
| IBasicVideo：：get_VideoHeight get_VideoHeight 方法會擷取影片的原生高度。 |
| IBasicVideo：：get_VideoWidth get_VideoWidth 方法會擷取影片的原生寬度。 |
| IBasicVideo：：GetCurrentImage GetCurrentImage 方法會擷取在轉譯器等候的目前影像。 |
| IBasicVideo：：GetDestinationPosition GetDestinationPosition 方法會擷取目的矩形的位置。 |
| IBasicVideo：：GetSourcePosition GetSourcePosition 方法會擷取來源矩形的位置。 |
| IBasicVideo：：GetVideoPaletteEntries GetVideoPaletteEntries 方法會擷取影片的調色盤色彩。 |
| IBasicVideo：：GetVideoSize GetVideoSize 方法會擷取原生視訊維度。 |
| IBasicVideo：：IsUsingDefaultDestination IsUsingDefaultDestination 方法會查詢轉譯器是否使用預設目的地矩形。 |
| IBasicVideo：：IsUsingDefaultSource IsUsingDefaultSource 方法會查詢轉譯器是否使用預設來源矩形。 |
| IBasicVideo：:p ut_DestinationHeight put_DestinationHeight方法會設定目的矩形的高度。 |
| IBasicVideo：:p ut_DestinationLeft put_DestinationLeft 方法會設定目的矩形的 X 座標。 |
| IBasicVideo：:p ut_DestinationTop put_DestinationTop 方法會設定目的矩形的 Y 座標。 |
| IBasicVideo：:p ut_DestinationWidth put_DestinationWidth 方法會設定目的矩形的寬度。 |
| IBasicVideo：:p ut_SourceHeight put_SourceHeight 方法會設定來源矩形的高度。 |
| IBasicVideo：:p ut_SourceLeft put_SourceLeft 方法會設定來源矩形的 X 座標。 |
| IBasicVideo：:p ut_SourceTop put_SourceTop 方法會設定來源矩形的 Y 座標。 |
| IBasicVideo：:p ut_SourceWidth put_SourceWidth 方法會設定來源矩形的寬度。 |
| IBasicVideo：：SetDefaultDestinationPosition SetDefaultDestinationPosition 方法會還原為預設目的地矩形。 呼叫這個方法之後，視訊轉譯器會使用整個視窗播放。 |
| IBasicVideo：：SetDefaultSourcePosition SetDefaultSourcePosition 方法會還原為預設來源矩形。 呼叫此方法之後，影片轉譯器會使用整個視訊影像，而不裁剪。 |
| IBasicVideo：：SetDestinationPosition SetDestinationPosition 方法會設定目的矩形。 |
| IBasicVideo：：SetSourcePosition SetSourcePosition 方法會設定來源矩形。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | control.h (包含 Dshow.h) |