共用方式為

(strmif.h) ICodecAPI：：GetParameterValues 方法

  • 發行項

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

GetParameterValues方法會取得編解碼器屬性的可能值清單。

這個方法只適用于支援可能值清單的屬性，而不是線性範圍。

語法

HRESULT GetParameterValues(
  [in]  const GUID *Api,
  [out] VARIANT    **Values,
  [out] ULONG      *ValuesCount
);

參數

[in] Api

GUID 的指標，指定要查詢的屬性。 如需標準編解碼器屬性的清單，請參閱 Codec API 屬性。

[out] Values

接收 VARIANT 型別陣列的指標。 陣列包含編碼器支援此屬性的值清單。 呼叫端必須呼叫VariantClear來釋放每個VARIANT。 呼叫端也必須呼叫 CoTaskMemFree來釋放陣列。

[out] ValuesCount

接收 Values 陣列中的專案數目。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼 描述
S_OK
 此方法已成功。
E_INVALIDARG
 無效引數。
VFW_E_CODECAPI_LINEAR_RANGE
 屬性支援值範圍，而非清單。

備註

如果屬性支援某個範圍的值，而不是清單，此方法會 傳回VFW_E_CODECAPI_LINEAR_RANGE。 在此情況下，請呼叫 ICodecAPI：：GetParameterRange 以取得值的範圍。

規格需求

   
最低支援的用戶端 Windows XP with SP2 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

編解碼器 API 參考

編碼器 API

ICodecAPI