Metodo ID2D1EffectContext::CreateEffect (d2d1effectauthor.h)

  • Articolo

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

Vedi anche

D2D1_BLEND_DESCRIPTION

Effetti

ID2D1BlendTransform

ID2D1EffectContext