ID2D1ResourceTexture::Update method (d2d1effectauthor.h)

Updates the specific resource texture inside the specific range or box using the supplied data.

Syntax

HRESULT Update(
  [in, optional] const UINT32 *minimumExtents,
  [in, optional] const UINT32 *maximimumExtents,
  [in]           const UINT32 *strides,
                 UINT32       dimensions,
  [in]           const BYTE   *data,
                 UINT32       dataCount
);

Parameters

[in, optional] minimumExtents

Type: const UINT32*

The "left" extent of the updates if specified; if NULL, the entire texture is updated.

[in, optional] maximimumExtents

Type: const UINT32*

The "right" extent of the updates if specified; if NULL, the entire texture is updated.

[in] strides

Type: const UINT32*

The stride to advance through the input data, according to dimension.

dimensions

Type: UINT32

The number of dimensions in the resource texture. This must match the number used to load the texture.

[in] data

Type: const BYTE*

The data to be placed into the resource texture.

dataCount

Type: UINT32

The size of the data buffer to be used to update the resource texture.

Return value

Type: HRESULT

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

HRESULT Description
S_OK No error occurred.
E_OUTOFMEMORY Direct2D could not allocate sufficient memory to complete the call.
E_INVALIDARG An invalid parameter was passed to the returning function.

Remarks

The number of dimensions in the update must match those of the created texture.

Requirements

Requirement Value
Minimum supported client Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header d2d1effectauthor.h
Library D2d1.lib

See also

ID2D1EffectContext::CreateResourceTexture

ID2D1ResourceTexture