Compartir a través de

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

  • Artículo

Devuelve los identificadores de clase de los efectos registrados actualmente y los efectos globales en esta fábrica.

Sintaxis

HRESULT GetRegisteredEffects(
  [out]           CLSID  *effects,
                  UINT32 effectsCount,
  [out]           UINT32 *effectsReturned,
  [out, optional] UINT32 *effectsRegistered
);

Parámetros

[out] effects

Tipo: CLSID*

Cuando este método devuelve, contiene una matriz de efectos. NULL si no se recuperan efectos.

effectsCount

Tipo: UINT32

Capacidad de la matriz de efectos .

[out] effectsReturned

Tipo: UINT32*

Cuando este método vuelve, contiene el número de efectos copiados en efectos.

[out, optional] effectsRegistered

Tipo: UINT32*

Cuando este método vuelve, contiene el número de efectos registrados actualmente en el sistema.

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.
E_OUTOFMEMORY Direct2D no pudo asignar memoria suficiente para completar la llamada.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) effectsRegistered es mayor que effectCount.

Comentarios

La API devolverá atómicamente el conjunto de identificadores de clase. El conjunto no se interrumpirá con otros subprocesos que registran o anulan el registro de los efectos.

Si effectsRegistered es mayor que effectCount, la matriz proporcionada se rellenará a la capacidad con el conjunto actual de efectos registrados. Este método devuelve los CLSID para todos los efectos globales y todos los efectos registrados en esta fábrica.

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::RegisterEffect