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
È 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 |