ID2D1ImageSource::TryReclaimResources メソッド (d2d1_3.h)

OfferResources を呼び出して以前に提供されていたリソースへのアクセスを復元します。

構文

HRESULT TryReclaimResources(
  [out] BOOL *resourcesDiscarded
);

パラメーター

[out] resourcesDiscarded

種類: BOOL*

対応するリソースのコンテンツが破棄され、未定義になった場合は TRUE、対応するリソースの古いコンテンツがまだそのままである場合は FALSE を返します。 呼び出し元が古いコンテンツが破棄されたかどうかに関係なく、リソースに新しいコンテンツを入力する場合、呼び出し元は NULL を渡すことができます。

戻り値

種類: HRESULT

ReclaimResources は次を 返します。

  • リソースが正常に回収されたかどうかをS_OKする
  • リソースが無効な場合にE_INVALIDARGする

解説

OfferResources を呼び出して 1 つ以上のリソースを提供した後、それらのリソースをもう一度使用するには、TryReclaimResources を呼び出す必要があります。 リソースのコンテンツが破棄されたかどうかを判断するには、resourcesDiscarded の値をチェックする必要があります。 リソースのコンテンツが提供されている間に破棄された場合、その現在のコンテンツは未定義です。 そのため、リソースを使用する前に、リソースのコンテンツを上書きする必要があります。

必要条件

   
対象プラットフォーム Windows
ヘッダー d2d1_3.h
Library D2D1.lib
[DLL] D2D1.dll

関連項目

ID2D1ImageSource