Metodo ID2D1DeviceContext::CreateEffect (d2d1_1.h)
Crea un effetto per l'ID classe specificato.
Sintassi
HRESULT CreateEffect(
REFCLSID effectId,
[out] ID2D1Effect **effect
);
Parametri
effectId
Tipo: REFCLSID
ID classe dell'effetto da creare. Per un elenco di ID effetto, vedere Effetti predefiniti .
[out] effect
Tipo: ID2D1Effect**
Quando questo metodo restituisce, contiene l'indirizzo di un puntatore a un nuovo 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. |
| E_NOTFOUND | Altri possibili HRESULT per un effetto non registrato (ad esempio D2DERR_EFFECT_IS_NOT_REGISTERED). |
| D2DERR_INSUFFICIENT_DEVICE_CAPABILITIES | L'effetto richiede funzionalità non supportate dal dispositivo D2D. |
Commenti
Se l'effetto creato è un effetto personalizzato implementato in una DLL, questo non incrementa il conteggio dei riferimenti per tale DLL. Se l'applicazione elimina un effetto durante il caricamento di tale effetto, 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 | d2d1_1.h |
| DLL | D2d1.dll |