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

另请参阅

ID2D1DeviceContext::CreateEffect

ID2D1Properties