Método ID2D1DeviceContext::GetEffectInvalidRectangles (d2d1_1.h)

Obtiene los rectángulos no válidos que se han acumulado desde la última vez que se ha dibujado el efecto y se llamó a EndDraw en el contexto del dispositivo.

Sintaxis

HRESULT GetEffectInvalidRectangles(
  [in]  ID2D1Effect *effect,
  [out] D2D1_RECT_F *rectangles,
  [in]  UINT32      rectanglesCount
);

Parámetros

[in] effect

Tipo: ID2D1Effect*

Efecto del que se obtienen los rectángulos no válidos.

[out] rectangles

Tipo: D2D1_RECT_F*

Matriz de estructuras de D2D1_RECT_F . Debe asignarlo al tamaño correcto. Puede obtener el recuento de los rectángulos no válidos mediante el método GetEffectInvalidRectangleCount .

[in] rectanglesCount

Tipo: UINT32

Número de rectángulos que se van a obtener.

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 suficiente memoria para completar la llamada.
E_INVALIDARG	Se pasó un parámetro no válido a la función de devolución.

Comentarios

Nota Direct2D no usa automáticamente estos rectángulos no válidos para reducir la región de un efecto que se representa.

 

Puedes usar el método InvalidateEffectInputRectangle para especificar rectángulos invalidados para que Direct2D se propague a través de un gráfico de efectos.

Si se solicitan varios rectángulos no válidos, los rectángulos que devuelve este método pueden superponerse. Cuando este es el caso, el recuento de rectángulos puede ser menor que el recuento que GetEffectInvalidRectangleCount.

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
Archivo DLL	D2d1.dll

Consulte también

ID2D1DeviceContext