Metodo ID2D1Factory1::GetEffectProperties (d2d1_1.h)

Recupera le proprietà di un effetto.

Sintassi

HRESULT GetEffectProperties(
  [in]  REFCLSID        effectId,
  [out] ID2D1Properties **properties
);

Parametri

[in] effectId

Tipo: REFCLSID

ID dell'effetto da cui recuperare le proprietà.

[out] properties

Tipo: ID2D1Properties**

Quando questo metodo restituisce, contiene l'indirizzo di un puntatore all'interfaccia della proprietà che può essere usata per eseguire query sui metadati dell'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.
D2DERR_EFFECT_IS_NOT_REGISTERED	Impossibile trovare l'effetto richiesto.
E_OUTOFMEMORY	Direct2D non è riuscito a allocare memoria sufficiente per completare la chiamata.

Commenti

Le proprietà dell'effetto restituite avranno tutte le proprietà modificabili per l'effetto impostate su un valore NULL predefinito o un valore vuoto.

• I tipi di valore verranno riempiti senza riempimento.
• I tipi BLOB e stringa saranno a lunghezza zero.
• I tipi di matrice avranno lunghezza 1 e l'elemento della matrice sarà conforme alle regole precedenti.

Questo metodo non può essere usato per restituire le proprietà per qualsiasi effetto non visibile a ID2D1DeviceContext::CreateEffect.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 e Aggiornamento della piattaforma 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
Libreria	D2d1.lib
DLL	D2d1.dll

Vedi anche

ID2D1Factory1

ID2D1Factory1::GetRegisteredEffects

ID2D1Factory1::RegisterEffect