IMediaSeeking：：CheckCapabilities 方法 (strmif.h)

  • 發行項

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

CheckCapabilities 方法會查詢數據流是否有指定的搜尋功能。

語法

HRESULT CheckCapabilities(
  [in, out] DWORD *pCapabilities
);

參數

[in, out] pCapabilities

在輸入時，變數的指標包含一或多個AM_SEEKING_SEEKING_CAPABILITIES屬性的位 OR。 當方法傳回時，值會指出有哪些屬性可供使用。

傳回值

傳回 HRESULT 值。 可能的值如下。

傳回碼 Description
S_FALSE
 pCapabilities 中的部分但並非所有功能都存在。
S_OK
 pCapabilities 中的所有功能都存在。
E_FAIL
 pCapabilities 中沒有任何功能存在。
E_POINTER
 NULL 指標自變數。

備註

如果您只對一些特定功能感興趣，則呼叫此方法比呼叫 IMediaSeeking：：GetCapabilities 更有效率，這會檢查所有數據流的搜尋功能。

若要呼叫此方法，請宣告 DWORD 變數，並將值設定為您要測試之AM_SEEKING_SEEKING_CAPABILITIES旗標的位 OR 組合。 在 pCapabilities 參數中傳遞此值的位址。 當方法傳回時， pCapabilities 會包含原始位的子集，指出有哪些功能存在。 傳回值會指出某些、無或所有要求的功能都存在。

下列程式代碼範例示範如何找出數據流是否支援向前搜尋、向後搜尋和絕對搜尋。

C++ 
設定您想要檢查之功能的旗標。

DWORD dwCaps = AM_SEEKING_CanSeekAbsolute |AM_SEEKING_CanSeekForwards |AM_SEEKING_CanSeekBackwards;


HRESULT hr = pMediaSeeking-CheckCapabilities> (&dwCaps) ;如果 (FAILED (hr) ) { + 數據流無法搜尋。
} else if (hr == S_OK) {

// The stream can seek forward, backward, and to an absolute position.
}
else if (hr == S_FALSE) // The stream has some of the capabilities.
{
if (dwCaps & AM_SEEKING_CanSeekAbsolute)
{
// The stream can seek to an absolute position.
}
if (dwCaps & AM_SEEKING_CanSeekForwards)
{
// The stream can seek forward.
}
if (dwCaps & AM_SEEKING_CanSeekBackwards)
{
// The stream can seek backward.
}
}

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IMediaSeeking 介面