Método ID2D1Factory1::GetEffectProperties (d2d1_1.h)

Recupera las propiedades de un efecto.

Sintaxis

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

Parámetros

[in] effectId

Tipo: REFCLSID

Identificador del efecto del que se van a recuperar las propiedades.

[out] properties

Tipo: ID2D1Properties**

Cuando este método devuelve, contiene la dirección de un puntero a la interfaz de propiedad que se puede usar para consultar los metadatos del efecto.

Valor devuelto

Tipo: HRESULT

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

HRESULT	Descripción
S_OK	No se ha producido ningún error.
D2DERR_EFFECT_IS_NOT_REGISTERED	No se encontró el efecto solicitado.
E_OUTOFMEMORY	Direct2D no pudo asignar suficiente memoria para completar la llamada.

Comentarios

Las propiedades de efecto devuelto tendrán todas las propiedades mutables del efecto establecida en un valor predeterminado de NULL o un valor vacío.

• Los tipos de valor se rellenarán en cero.
• Los tipos de blob y cadena serán de longitud cero.
• Los tipos de matriz tendrán la longitud 1 y el elemento de la matriz se ajustará a las reglas anteriores.

Este método no se puede usar para devolver las propiedades de ningún efecto no visible para ID2D1DeviceContext::CreateEffect.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	d2d1_1.h
Library	D2d1.lib
Archivo DLL	D2d1.dll

Consulte también

ID2D1Factory1

ID2D1Factory1::GetRegisteredEffects

ID2D1Factory1::RegisterEffect