Share via


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_INPUTSD2D1_PROPERTY_MAX_INPUTS 值來判斷效果支援的輸入數目。

如果輸入計數小於最小或大於支援的輸入上限,則呼叫將會失敗。

如果輸入計數未變更,則呼叫會成功 並S_OK

除非輸入數目較小,否則目前在此呼叫上選取的任何輸入都會取消變更。 如果輸入數目較小,則會釋放超出所選範圍的輸入。

如果方法失敗,現有的輸入和輸入計數將會保持不變。

規格需求

   
最低支援的用戶端 適用于 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 適用于 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d2d1_1.h
Dll D2d1.dll

另請參閱

ID2D1DeviceCoNtext::CreateEffect

ID2D1DeviceCoNtext::D rawImage

ID2D1Effect

ID2D1Effect::GetOutput

ID2D1Image