Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ID2D1Properties::SetValueByName(PCWSTR, const BYTE*, UINT32) method

Sets the named property to the given value.

Syntax


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

Parameters

name [in]

Type: PCWSTR

The name of the property to set.

data [in]

Type: const BYTE*

The data to set.

dataSize

Type: UINT32

The number of bytes in the data to set.

Return value

Type: HRESULT

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

HRESULTDescription
S_OKNo error occurred.
D2DERR_INVALID_PROPERTYThe specified property does not exist.
E_OUTOFMEMORYFailed to allocate necessary memory.
D3DERR_OUT_OF_VIDEO_MEMORYFailed to allocate required video memory.
E_INVALIDARGOne or more arguments are invalid.
E_FAILUnspecified failure.

 

Remarks

If the property does not exist, the request is ignored and the method returns D2DERR_INVALID_PROPERTY.

Any error not in the standard set returned by a property implementation will be mapped into the standard error range.

Requirements

Minimum supported client

Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Header

D2d1_1.h

Library

D2d1.lib

DLL

D2d1.dll

See also

ID2D1Properties
ID2D1DeviceContext::CreateEffect

 

 

Show:
© 2017 Microsoft