Edit

ID2D1ImageSource::TryReclaimResources method (d2d1_3.h)

  • Article

Restores access to resources that were previously offered by calling OfferResources.

Syntax

HRESULT TryReclaimResources(
  [out] BOOL *resourcesDiscarded
);

Parameters

[out] resourcesDiscarded

Type: BOOL*

Returns with TRUE if the corresponding resource’s content was discarded and is now undefined, or FALSE if the corresponding resource’s old content is still intact. The caller can pass in NULL, if the caller intends to fill the resources with new content regardless of whether the old content was discarded.

Return value

Type: HRESULT

ReclaimResources returns:

  • S_OK if resources were successfully reclaimed
  • E_INVALIDARG if the resources are invalid

Remarks

After you call OfferResources to offer one or more resources, you must call TryReclaimResources before you can use those resources again. You must check the value in the resourcesDiscarded to determine whether the resource’s content was discarded. If a resource’s content was discarded while it was offered, its current content is undefined. Therefore, you must overwrite the resource’s content before you use the resource.

Requirements

Requirement Value
Target Platform Windows
Header d2d1_3.h
Library D2D1.lib
DLL D2D1.dll

See also

ID2D1ImageSource