共用方式為


ID2D1Properties::SetValueByName (PCWSTR,constBYTE*,UINT32) 方法 (d2d1_1.h)

將具名屬性設定為指定的值。

語法

HRESULT SetValueByName(
  [in] PCWSTR     name,
  [in] const BYTE *data,
       UINT32     dataSize
);

參數

[in] name

類型: PCWSTR

所要設定的屬性名稱。

[in] data

類型: const BYTE*

要設定的資料。

dataSize

類型: UINT32

要設定之資料中的位元組數目。

傳回值

類型: HRESULT

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

HRESULT 描述
S_OK 未發生任何錯誤。
D2DERR_INVALID_PROPERTY 指定的屬性不存在。
E_OUTOFMEMORY 無法配置必要的記憶體。
D3DERR_OUT_OF_VIDEO_MEMORY 無法配置必要的視訊記憶體。
E_INVALIDARG 一或多個引數無效。
E_FAIL 未指定的失敗。

備註

如果屬性不存在,則會忽略要求,而且方法會傳回 D2DERR_INVALID_PROPERTY

屬性實作所傳回之標準集合中的任何錯誤都會對應至標準錯誤範圍。

規格需求

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

另請參閱

ID2D1DeviceCoNtext::CreateEffect

ID2D1Properties