IAMStreamConfig::GetNumberOfCapabilities 方法 (strmif.h)
[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼,以使用新的 API。]
方法 GetNumberOfCapabilities
會擷取這個針腳所支援的格式功能數目。
語法
HRESULT GetNumberOfCapabilities(
[out] int *piCount,
[out] int *piSize
);
參數
[out] piCount
接收格式功能數目的變數指標。
[out] piSize
以位元組為單位接收組態結構大小的變數指標。 如需詳細資訊,請參閱「備註」。
傳回值
傳回 HRESULT 值。 可能的值如下。
傳回碼 | 描述 |
---|---|
|
成功。 |
|
Null 指標值。 |
|
輸入針腳未連接。 |
備註
輸出針腳可以支援一組以上的格式功能。 這個方法會傳回針腳支援的功能總數; 數位會在 piCount 參數中傳回。 若要擷取一組特定的功能,請呼叫 IAMStreamConfig::GetStreamCaps 方法。 格式功能會從零編制索引,因此 piCount 中傳回的值是一個以上的上限。
視針腳的格式類型而定,視訊) 的 VIDEO_STREAM_CONFIG_CAPS 結構 (或音訊) 的 AUDIO_STREAM_CONFIG_CAPS 結構 (。 piSize參數會接收 結構的大小,以位元組為單位。
在某些壓縮篩選上,如果篩選準則的輸入針腳未連接,這個方法就會失敗。
規格需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | strmif.h (包含 Dshow.h) |
程式庫 | Strmiids.lib |