Metodo ID2D1DeviceContext::GetEffectInvalidRectangles (d2d1_1.h)

Ottiene i rettangoli non validi accumulati dall'ultima volta che l'effetto è stato disegnato e EndDraw è stato chiamato nel contesto del dispositivo.

Sintassi

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

Parametri

[in] effect

Tipo: ID2D1Effect*

Effetto da cui ottenere i rettangoli non validi.

[out] rectangles

Tipo: D2D1_RECT_F*

Matrice di strutture D2D1_RECT_F . È necessario allocare questa proprietà alle dimensioni corrette. È possibile ottenere il conteggio dei rettangoli non validi usando il metodo GetEffectInvalidRectangleCount .

[in] rectanglesCount

Tipo: UINT32

Numero di rettangoli da ottenere.

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.
E_OUTOFMEMORY Direct2D non è riuscito a allocare memoria sufficiente per completare la chiamata.
E_INVALIDARG Un parametro non valido è stato passato alla funzione restituita.

Commenti

Nota Direct2D non usa automaticamente questi rettangoli non validi per ridurre l'area di un effetto sottoposto a rendering.
 

È possibile usare il metodo InvalidateEffectInputRectangle per specificare rettangoli invalidati per Direct2D per propagare tramite un grafico degli effetti.

Se sono richiesti più rettangoli non validi, i rettangoli restituiti da questo metodo potrebbero sovrapporsi. Quando si tratta del caso, il conteggio dei rettangoli potrebbe essere inferiore al conteggio che GetEffectInvalidRectangleCount.

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

Vedi anche

ID2D1DeviceContext