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

ID2D1DeviceContext::D rawImage

ID2D1Effect

ID2D1Effect::GetOutput

ID2D1Image