ID2D1Properties：：GetValueByName (PCWSTR，BYTE*，UINT32) 方法 (d2d1_1.h)
依名稱取得屬性值。
語法
HRESULT GetValueByName(
[in] PCWSTR name,
[out] BYTE *data,
UINT32 dataSize
);
參數
[in] name
類型： PCWSTR
要取得的屬性名稱。
[out] data
類型： BYTE*
當這個方法傳回時，包含具有資料值的緩衝區。
dataSize
類型： UINT32
要擷取之資料中的位元組數目。
傳回值
類型： HRESULT
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| HRESULT | 描述 |
|---|---|
| S_OK | 未發生任何錯誤。 |
| D2DERR_INVALID_PROPERTY | 指定的屬性不存在。 |
| E_OUTOFMEMORY | 無法配置必要的記憶體。 |
| D3DERR_OUT_OF_VIDEO_MEMORY | 無法配置必要的視訊記憶體。 |
| E_INVALIDARG | 一或多個引數無效。 |
| E_FAIL | 未指定的失敗。 |
備註
如果 名稱 不存在，則不會擷取任何資訊。
屬性實作所傳回之標準集合中的任何錯誤都會對應至標準錯誤範圍。
規格需求
| 最低支援的用戶端 | 適用于 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | 適用于 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | d2d1_1.h |
| 程式庫 | D2d1.lib |
| Dll | D2d1.dll |