共用方式為


ID2D1Factory1::GetEffectProperties 方法 (d2d1_1.h)

擷取效果的屬性。

語法

HRESULT GetEffectProperties(
  [in]  REFCLSID        effectId,
  [out] ID2D1Properties **properties
);

參數

[in] effectId

類型: REFCLSID

要從中擷取屬性的效果標識碼。

[out] properties

類型: ID2D1Properties**

當這個方法傳回時,會包含屬性介面指標的位址,可用來查詢效果的元數據。

傳回值

類型: HRESULT

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

HRESULT 描述
S_OK 未發生任何錯誤。
D2DERR_EFFECT_IS_NOT_REGISTERED 找不到要求的效果。
E_OUTOFMEMORY Direct2D 無法配置足夠的記憶體來完成呼叫。

備註

傳回的效果屬性會將效果設定為預設值為 NULL 或空白值的所有可變動屬性。

  • 實值類型會以零填滿。
  • Blob 和字串類型將會是零長度。
  • 陣列類型長度為1,而陣列的元素將符合先前的規則。
這個方法無法用來傳回 ID2D1DeviceContext::CreateEffect看不到之任何效果的屬性。

規格需求

需求
最低支援的用戶端 適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d2d1_1.h
程式庫 D2d1.lib
Dll D2d1.dll

另請參閱

ID2D1Factory1

ID2D1Factory1::GetRegisteredEffects

ID2D1Factory1::RegisterEffect