ID2D1Effect::SetInputCount-Methode (d2d1_1.h)
Ermöglicht der Anwendung, die Anzahl der Eingaben in einen Effekt zu ändern.
Syntax
HRESULT SetInputCount(
UINT32 inputCount
);
Parameter
inputCount
Typ: UINT32
Die Anzahl der Eingaben für den Effekt.
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_INVALIDARG | Mindestens ein Argument ist ungültig. |
| E_OUTOFMEMORY | Fehler beim Zuweisen des erforderlichen Arbeitsspeichers. |
Hinweise
Die meisten Effekte unterstützen keine variable Anzahl von Eingaben. Verwenden Sie ID2D1Properties::GetValue mit den werten D2D1_PROPERTY_MIN_INPUTS und D2D1_PROPERTY_MAX_INPUTS , um die Anzahl der eingaben zu bestimmen, die von einem Effekt unterstützt werden.
Wenn die Eingabeanzahl kleiner als das Minimum oder mehr als die maximal unterstützten Eingaben ist, schlägt der Aufruf fehl.
Wenn die Eingabeanzahl unverändert ist, wird der Aufruf mit S_OK erfolgreich ausgeführt.
Alle Eingaben, die derzeit für den Effekt ausgewählt sind, werden durch diesen Aufruf unverändert, es sei denn, die Anzahl der Eingaben wird kleiner. Wenn die Anzahl der Eingaben kleiner wird, werden Eingaben außerhalb des ausgewählten Bereichs freigegeben.
Wenn die Methode fehlschlägt, bleiben die vorhandene Eingabe- und Eingabeanzahl unverändert.
Anforderungen
| 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 |
Weitere Informationen
ID2D1DeviceContext::CreateEffect