Metodo ID2D1Effect::SetInputCount (d2d1_1.h)

Articolo
08/22/2023

Consente all'applicazione di modificare il numero di input in un effetto.

Sintassi

HRESULT SetInputCount(
  UINT32 inputCount
);

Parametri

inputCount

Tipo: UINT32

Numero di input per l'effetto.

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_INVALIDARG	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Impossibile allocare la memoria necessaria.

Commenti

La maggior parte degli effetti non supporta un numero variabile di input. Usare ID2D1Properties::GetValue con i valori D2D1_PROPERTY_MIN_INPUTS e D2D1_PROPERTY_MAX_INPUTS per determinare il numero di input supportati da un effetto.

Se il numero di input è minore del numero minimo o superiore agli input massimi supportati, la chiamata avrà esito negativo.

Se il conteggio di input è invariato, la chiamata avrà esito positivo con S_OK.

Tutti gli input attualmente selezionati sull'effetto saranno invariati da questa chiamata a meno che il numero di input non venga ridotto. Se il numero di input viene ridotto, gli input oltre l'intervallo selezionato verranno rilasciati.

Se il metodo ha esito negativo, il conteggio di input e input esistente rimarrà invariato.

Requisiti


Client minimo supportato	Windows 8 e Platform Update 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