Partager via


ID2D1Effect::SetInputCount, méthode (d2d1_1.h)

Permet à l’application de modifier le nombre d’entrées en un effet.

Syntaxe

HRESULT SetInputCount(
  UINT32 inputCount
);

Paramètres

inputCount

Type : UINT32

Nombre d’entrées de l’effet.

Valeur retournée

Type : HRESULT

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

HRESULT Description
S_OK Aucune erreur ne s'est produite.
E_INVALIDARG Un ou plusieurs arguments ne sont pas valides.
E_OUTOFMEMORY Échec de l’allocation de la mémoire nécessaire.

Remarques

La plupart des effets ne prennent pas en charge un nombre variable d’entrées. Utilisez ID2D1Properties::GetValue avec les valeurs D2D1_PROPERTY_MIN_INPUTS et D2D1_PROPERTY_MAX_INPUTS pour déterminer le nombre d’entrées prises en charge par un effet.

Si le nombre d’entrées est inférieur au minimum ou supérieur au nombre maximal d’entrées prises en charge, l’appel échoue.

Si le nombre d’entrées est inchangé, l’appel réussit avec S_OK.

Toutes les entrées actuellement sélectionnées sur l’effet ne seront pas modifiées par cet appel, sauf si le nombre d’entrées est réduit. Si le nombre d’entrées est réduit, les entrées au-delà de la plage sélectionnée sont libérées.

Si la méthode échoue, le nombre d’entrées et d’entrées existants reste inchangé.

Configuration requise

   
Client minimal pris en charge Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 et Platform Update pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête d2d1_1.h
DLL D2d1.dll

Voir aussi

ID2D1DeviceContext::CreateEffect

ID2D1DeviceContext::D rawImage

ID2D1Effect

ID2D1Effect::GetOutput

ID2D1Image