按名称获取属性值。 这是模板重载。 请参阅“备注”。
语法
HRESULT GetValueByName(
[in] PCWSTR propertyName,
[out] T *value
);
参数
[in] propertyName
类型：PCWSTR
要获取的属性名称。
[out] value
类型：T*
此方法返回时，包含值。
返回值
类型：HRESULT
该方法返回 HRESULT。 可能的值包括但不限于下表中的值。
| HRESULT | 描述 |
|---|---|
| S_OK | 未发生错误。 |
| D2DERR_INVALID_PROPERTY | 指定的属性不存在。 |
| E_OUTOFMEMORY | 未能分配必要的内存。 |
| D3DERR_OUT_OF_VIDEO_MEMORY | 未能分配所需的视频内存。 |
| E_INVALIDARG | 一个或多个参数无效。 |
| E_FAIL | 未指定的失败。 |
言论
如果 propertyName 不存在，则不会检索任何信息。
属性实现返回的标准集中未返回的任何错误都将映射到标准错误范围。
template<typename T>
HRESULT GetValueByName(
_In_ PCWSTR propertyName,
_Out_ T *value
) const;
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 适用于 Windows 7 的 Windows 8 和平台更新 [桌面应用 |UWP 应用] |
| 支持的最低服务器 | 适用于 Windows Server 2008 R2 的 Windows Server 2012 和平台更新 [桌面应用 |UWP 应用] |
| 目标平台 | 窗户 |
| 标头 | d2d1_1.h |
| 库 | D2d1.lib |
| DLL | D2d1.dll |