ID2D1DeviceContext::GetEffectInvalidRectangles-Methode (d2d1_1.h)
Ruft die ungültigen Rechtecke ab, die sich seit dem letzten Gezeichnet des Effekts und dem Aufruf von EndDraw im Gerätekontext angesammelt haben.
Syntax
HRESULT GetEffectInvalidRectangles(
[in] ID2D1Effect *effect,
[out] D2D1_RECT_F *rectangles,
[in] UINT32 rectanglesCount
);
Parameter
[in] effect
Typ: ID2D1Effect*
Der Effekt, aus dem die ungültigen Rechtecke abgerufen werden sollen.
[out] rectangles
Typ: D2D1_RECT_F*
Ein Array von D2D1_RECT_F Strukturen. Sie müssen dies der richtigen Größe zuordnen. Sie können die Anzahl der ungültigen Rechtecke mithilfe der GetEffectInvalidRectangleCount-Methode abrufen.
[in] rectanglesCount
Typ: UINT32
Die Anzahl der abzurufenden Rechtecke.
Rückgabewert
Typ: HRESULT
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| HRESULT | BESCHREIBUNG |
|---|---|
| S_OK | Kein Fehler ist aufgetreten. |
| E_OUTOFMEMORY | Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Anruf abzuschließen. |
| E_INVALIDARG | Ein ungültiger Parameter wurde an die zurückgebende Funktion übergeben. |
Hinweise
Sie können die InvalidateEffectInputRectangle-Methode verwenden, um ungültige Rechtecke für Direct2D anzugeben, die über ein Effektdiagramm weitergegeben werden sollen.
Wenn mehrere ungültige Rechtecke angefordert werden, können sich die von dieser Methode zurückgegebenen Rechtecke überschneiden. Wenn dies der Fall ist, ist die Anzahl der Rechtecke möglicherweise niedriger als die Anzahl von GetEffectInvalidRectangleCount.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | d2d1_1.h |
| DLL | D2d1.dll |