Creates a Direct2D effect for the specified class ID. This is the same as ID2D1DeviceContext::CreateEffect so custom effects can create other effects and wrap them in a transform.
HRESULT CreateEffect( REFCLSID effectId, [out] ID2D1Effect **effect );
The built-in or registered effect ID to create the effect. See Built-in Effects for a list of effect IDs.
- effect [out]
When this method returns, contains the address of a pointer to the effect.
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
|S_OK||No error occurred.|
|E_OUTOFMEMORY||Direct2D could not allocate sufficient memory to complete the call.|
|E_INVALIDARG||An invalid value was passed to the method.|
|D3DERR_OUTOFVIDEOMEMORY||Direct3D does not have enough display memory to perform the operation.|
|D2DERR_EFFECT_IS_NOT_REGISTERED||The specified effect is not registered by the system.|
The created effect does not reference count the DLL from which the effect was created. If the caller unregisters an effect while this effect is loaded, the resulting behavior is unpredictable.
Minimum supported client
|Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps]|
Minimum supported server
|Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | Windows Store apps]|
Minimum supported phone
|Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]|