ID2D1Factory1：：GetRegisteredEffects 方法 (d2d1_1.h)

  • 發行項

傳回目前註冊效果的類別標識碼，以及此處理站的全域效果。

語法

HRESULT GetRegisteredEffects(
  [out]           CLSID  *effects,
                  UINT32 effectsCount,
  [out]           UINT32 *effectsReturned,
  [out, optional] UINT32 *effectsRegistered
);

參數

[out] effects

類型： CLSID*

當這個方法傳回時，會包含效果數位。 如果未擷取任何效果，則為NULL。

effectsCount

類型： UINT32

效果陣列的容量。

[out] effectsReturned

類型： UINT32*

當這個方法傳回時，包含複製到 效果的效果數目。

[out, optional] effectsRegistered

類型： UINT32*

當這個方法傳回時，會包含系統中目前註冊的效果數目。

傳回值

類型： HRESULT

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

HRESULT 描述
S_OK 未發生任何錯誤。
E_OUTOFMEMORY Direct2D 無法配置足夠的記憶體來完成呼叫。
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) effectsRegistered 大於 effectCount。

備註

API 會以不可部分完成的方式傳回類別標識碼集。 此集合不會遭到其他線程註冊或取消註冊效果所中斷。

如果 effectsRegistered 大於 effectCount，則提供的數位仍會填滿為目前註冊效果集的容量。 這個方法會傳回所有全域效果的CLSID，以及註冊至此處理站的所有效果。

規格需求

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

另請參閱

ID2D1Factory1

ID2D1Factory1：：RegisterEffect