ID2D1ImageSource::TryReclaimResources method

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

Syntax


HRESULT TryReclaimResources(
  [out] BOOL *resourcesDiscarded
);

Parameters

resourcesDiscarded [out]

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

Header

D2d1_3.h

Library

D2D1.lib

DLL

D2D1.dll

See also

ID2D1ImageSource

 

 

Show: