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 2012 和适用于 Windows Server 2008 R2 的平台更新 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | d2d1_1.h |
| Library | D2d1.lib |
| DLL | D2d1.dll |