ID2D1Effect::SetInputCount 方法 (d2d1_1.h)
允许应用程序将输入数更改为效果。
语法
HRESULT SetInputCount(
UINT32 inputCount
);
参数
inputCount
类型: UINT32
效果的输入数。
返回值
类型: HRESULT
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
HRESULT | 说明 |
---|---|
S_OK | 未发生错误。 |
E_INVALIDARG | 一个或多个参数无效。 |
E_OUTOFMEMORY | 未能分配必要的内存。 |
注解
大多数效果不支持可变数量的输入。 将 ID2D1Properties::GetValue 与 D2D1_PROPERTY_MIN_INPUTS 和 D2D1_PROPERTY_MAX_INPUTS 值一起使用,以确定效果支持的输入数。
如果输入计数小于最小或大于支持的最大输入数,则调用将失败。
如果输入计数保持不变,则调用将成功并 S_OK。
此调用不会更改当前对效果选择的任何输入,除非输入数减少。 如果输入数减少,则会释放超出所选范围的输入。
如果方法失败,现有输入和输入计数将保持不变。
要求
最低受支持的客户端 | 适用于 Windows 7 的 Windows 8 和平台更新 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2012 和适用于 Windows Server 2008 R2 的平台更新 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | d2d1_1.h |
DLL | D2d1.dll |
另请参阅
ID2D1DeviceContext::CreateEffect