Share via


IKsPropertySet::QuerySupported 方法

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

方法 QuerySupported 會判斷物件是否支援指定的屬性集。

語法

HRESULT QuerySupported(
  [in]  REFGUID guidPropSet,
  [in]  DWORD   dwPropID,
  [out] DWORD   *pTypeSupport
);

參數

guidPropSet [in]

屬性集 GUID。

dwPropID [in]

屬性集內屬性的識別碼。

pTypeSupport [out]

值的指標,用來儲存旗標,指出驅動程式所提供的支援。 支援的旗標包括下列專案。

Description
KSPROPERTY_SUPPORT_GET 您可以呼叫 IKsPropertySet::Get 方法來擷取屬性。
KSPROPERTY_SUPPORT_SET 您可以呼叫 IKsPropertySet::Set來變更屬性。

 

傳回值

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

傳回碼 描述
S_OK
支援指定的屬性集和屬性識別碼組合。
E_NOTIMPL
不支援屬性集。
E_PROP_ID_UNSUPPORTED
指定的屬性集不支援屬性識別碼。
E_PROP_SET_UNSUPPORTED
不支援屬性集。

 

備註

注意

此名稱的另一個介面存在於 dsound.h 標頭檔中。 這兩個介面不相容。 DirectShow DDK 中記載的 IKsControl 介面現在是在 WDM 驅動程式與使用者模式元件之間傳遞屬性集的建議介面。

 

您必須在 Ksproxy.h 之前包含 Ks.h。

規格需求

需求
最低支援的用戶端
Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限桌面應用程式]
標頭
Ks.h;
Ksproxy.h
程式庫
Strmiids.lib

另請參閱

錯誤和成功碼

IKsPropertySet 介面

屬性集