Поделиться через


Метод ID2D1Properties::GetValueByName(PCWSTR,T*) (d2d1_1.h)

Возвращает значение свойства по имени. Это перегрузка шаблона. См. примечания.

Синтаксис

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 Неуказанный сбой.

Замечания

Если свойствоName не существует, данные не извлекаются.

Любая ошибка, не в стандартном наборе, возвращаемом реализацией свойства, будет сопоставлена со стандартным диапазоном ошибок.

template<typename T>
    HRESULT GetValueByName(
        _In_ PCWSTR propertyName,
        _Out_ T *value
        ) const;

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 8 и Обновление платформы для Windows 7 [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP]
целевая платформа Виндоус
заголовка d2d1_1.h
библиотеки D2d1.lib
DLL D2d1.dll

См. также

ID2D1DeviceContext::CreateEffect

ID2D1Properties