ID2D1Effect::SetInputCount 方法 (d2d1_1.h)

允许应用程序将输入数更改为效果。

语法

HRESULT SetInputCount(
  UINT32 inputCount
);

参数

inputCount

类型: UINT32

效果的输入数。

返回值

类型: HRESULT

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

HRESULT 说明
S_OK 未发生错误。
E_INVALIDARG 一个或多个参数无效。
E_OUTOFMEMORY 未能分配必要的内存。

注解

大多数效果不支持可变数量的输入。 将 ID2D1Properties::GetValueD2D1_PROPERTY_MIN_INPUTSD2D1_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

ID2D1DeviceContext::D rawImage

ID2D1Effect

ID2D1Effect::GetOutput

ID2D1Image