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

Vedi anche

Effetti

ID2D1DeviceContext

ID2D1Effect

ID2D1Factory1::RegisterEffect