IEnumFilters::Skip 方法 (strmif.h)
[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。
方法 Skip
會略過指定的篩選數目。
語法
HRESULT Skip(
[in] ULONG cFilters
);
參數
[in] cFilters
要略過的篩選數目。
傳回值
值 | Description |
---|---|
S_FALSE | 略過序列結尾。 |
S_OK | 成功。 |
VFW_E_ENUM_OUT_OF_SYNC | 圖表已變更,且現在與列舉值不一致。 |
備註
例如,如果篩選圖表變更 (,應用程式會移除篩選) ,列舉值不再與圖形一致,而且方法會傳回VFW_E_ENUM_OUT_OF_SYNC。 捨棄從先前呼叫列舉值取得的任何資料,因為它可能無效。 呼叫 IEnumFilters::Reset 方法來更新列舉值。 然後,您可以安全地呼叫 Skip
方法。
規格需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | strmif.h (包含 Dshow.h) |
程式庫 | Strmiids.lib |