Compartilhar via


Método ID2D1Properties::GetValueByName(PCWSTR,T*) (d2d1_1.h)

Obtém o valor da propriedade por nome. Essa é uma sobrecarga de modelo. Consulte Comentários.

Sintaxe

HRESULT GetValueByName(
  [in]  PCWSTR propertyName,
  [out] T      *value
);

Parâmetros

[in] propertyName

Tipo: PCWSTR

O nome da propriedade a ser obtido.

[out] value

Tipo: T*

Quando esse método é retornado, contém o valor.

Valor de retorno

Tipo: HRESULT

O método retorna umHRESULT . Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir.

HRESULT Descrição
S_OK Nenhum erro ocorreu.
D2DERR_INVALID_PROPERTY A propriedade especificada não existe.
E_OUTOFMEMORY Falha ao alocar a memória necessária.
D3DERR_OUT_OF_VIDEO_MEMORY Falha ao alocar memória de vídeo necessária.
E_INVALIDARG Um ou mais argumentos são inválidos.
E_FAIL Falha não especificada.

Observações

Se propertyName não existir, nenhuma informação será recuperada.

Qualquer erro que não esteja no conjunto padrão retornado por uma implementação de propriedade será mapeado para o intervalo de erros padrão.

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

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 8 e Platform Update para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
servidor com suporte mínimo Windows Server 2012 e Platform Update para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino Windows
cabeçalho d2d1_1.h
biblioteca D2d1.lib
de DLL D2d1.dll

Consulte também

ID2D1DeviceContext::CreateEffect

ID2D1Properties