Compartilhar via


Método ID2D1Properties::SetValueByName(PCWSTR,constBYTE*,UINT32) (d2d1_1.h)

Define a propriedade nomeada como o valor fornecido.

Sintaxe

HRESULT SetValueByName(
  [in] PCWSTR     name,
  [in] const BYTE *data,
       UINT32     dataSize
);

Parâmetros

[in] name

Tipo: PCWSTR

O nome da propriedade a ser definida.

[in] data

Tipo: const BYTE*

Os dados a serem definidos.

dataSize

Tipo: UINT32

O número de bytes nos dados a serem definidos.

Valor retornado

Tipo: HRESULT

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

HRESULT Descrição
S_OK Não ocorreu nenhum erro.
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 a memória de vídeo necessária.
E_INVALIDARG Um ou mais argumentos são inválidos.
E_FAIL Falha não especificada.

Comentários

Se a propriedade não existir, a solicitação será ignorada e o método retornará D2DERR_INVALID_PROPERTY.

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.

Requisitos

   
Cliente mínimo com suporte Windows 8 e Platform Update para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 e Platform Update para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1_1.h
Biblioteca D2d1.lib
DLL D2d1.dll

Confira também

ID2D1DeviceContext::CreateEffect

ID2D1Propriedades