ID2D1Effect::SetInputCount メソッド (d2d1_1.h)

アプリケーションが入力の数を効果に変更できるようにします。

構文

HRESULT SetInputCount(
  UINT32 inputCount
);

inputCount

種類: UINT32

効果に対する入力の数。

種類: HRESULT

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

ほとんどの効果では、可変数の入力はサポートされていません。 ID2D1Properties::GetValue をD2D1_PROPERTY_MIN_INPUTS値とD2D1_PROPERTY_MAX_INPUTS値と共に使用して、効果でサポートされる入力の数を決定します。

入力カウントが、サポートされている入力の最小値より小さいか、サポートされている最大入力を超える場合、呼び出しは失敗します。

入力カウントが変更されていない場合、呼び出しは S_OK で成功します。

現在効果で選択されている入力は、入力の数を減らさない限り、この呼び出しによって変更されません。入力の数を小さくすると、選択した範囲を超える入力が解放されます。

メソッドが失敗した場合、既存の入力と入力数は変更されません。


サポートされている最小のクライアント	Windows 8 および Windows 7 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2012 および Windows Server 2008 R2 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	d2d1_1.h
[DLL]	D2d1.dll