CBaseMediaFilter.GetState 方法
[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。
方法 GetState 會擷取物件的狀態 (執行、停止或暫停) 。 這個方法會實作 IMediaFilter：：GetState 方法。
語法
HRESULT GetState(
DWORD dwMilliSecsTimeout,
FILTER_STATE *State
);
參數
-
dwMilliSecsTimeout
-
逾時間隔，以毫秒為單位。
-
State
-
接收 FILTER_STATE 列舉型別成員之變數的指標，表示物件的狀態。
傳回值
傳回S_OK或E_POINTER。
備註
在基類中，所有狀態轉換都是同步的，而且 會忽略 dwMilliSecsTimeout 參數。 如果衍生類別執行非同步狀態轉換，它應該覆寫這個方法以在狀態轉換期間等候，並逾時 dwMilliSecsTimeout 毫秒。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|