Metodo ID2D1EffectContext::CreateEffect (d2d1effectauthor.h)
Crea un effetto Direct2D per l'ID classe specificato. Questo è lo stesso di ID2D1DeviceContext::CreateEffect in modo che gli effetti personalizzati possano creare altri effetti e eseguirne il wrapping in una trasformazione.
Sintassi
HRESULT CreateEffect(
REFCLSID effectId,
[out] ID2D1Effect **effect
);
Parametri
effectId
Tipo: REFCLSID
ID effetto predefinito o registrato per creare l'effetto. Per un elenco di ID effetto, vedere Effetti predefiniti .
[out] effect
Tipo: ID2D1Effect**
Quando questo metodo restituisce, contiene l'indirizzo di un puntatore all'effetto.
Valore restituito
Tipo: HRESULT
Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| HRESULT | Descrizione |
|---|---|
| S_OK | Non si sono verificati errori. |
| E_OUTOFMEMORY | Direct2D non è riuscito a allocare memoria sufficiente per completare la chiamata. |
| E_INVALIDARG | Un valore non valido è stato passato al metodo. |
| D3DERR_OUTOFVIDEOMEMORY | Direct3D non dispone di memoria di visualizzazione sufficiente per eseguire l'operazione. |
| D2DERR_EFFECT_IS_NOT_REGISTERED | L'effetto specificato non è registrato dal sistema. |
Commenti
L'effetto creato non fa riferimento alla DLL da cui è stato creato l'effetto. Se il chiamante annulla la registrazione di un effetto mentre questo effetto viene caricato, il comportamento risultante è imprevedibile.
Requisiti
| Client minimo supportato | Windows 8 e Platform Update per Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2012 e Aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | d2d1effectauthor.h |
| Libreria | D2D1.lib |