Compartir a través de

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

  • Artículo

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