IDXGIDevice2::ReclaimResources 메서드(dxgi1_2.h)
IDXGIDevice2::OfferResources를 호출하여 이전에 제공된 리소스에 대한 액세스를 복원합니다.
구문
HRESULT ReclaimResources(
[in] UINT NumResources,
[in] IDXGIResource * const *ppResources,
[out, optional] BOOL *pDiscarded
);
매개 변수
[in] NumResources
ppResources 인수 및 pDiscarded 인수 배열의 리소스 수입니다.
[in] ppResources
회수할 리소스에 대한 IDXGIResource 인터페이스에 대한 포인터 배열입니다.
[out, optional] pDiscarded
부울 값을 받는 배열에 대한 포인터입니다. 배열의 각 값은 ppResources 매개 변수가 지정하는 것과 동일한 인덱스의 리소스에 해당합니다. 런타임은 해당 리소스의 콘텐츠가 삭제되어 정의되지 않은 경우 각 부울 값을 TRUE로 설정하거나 해당 리소스의 이전 콘텐츠가 그대로 유지되는 경우 FALSE로 설정합니다. 호출자가 이전 콘텐츠가 삭제되었는지 여부에 관계없이 리소스를 새 콘텐츠로 채우려는 경우 호출자는 NULL로 전달할 수 있습니다.
반환 값
ReclaimResources는 다음을 반환합니다.
- 리소스가 성공적으로 회수되었는지 S_OK
- 리소스가 잘못된 경우 E_INVALIDARG
설명
IDXGIDevice2::OfferResources를 호출하여 하나 이상의 리소스를 제공하려면 먼저 ReclaimResources를 호출해야 해당 리소스를 다시 사용할 수 있습니다. 각 리소스의 콘텐츠가 삭제되었는지 여부를 확인하려면 pDiscarded에서 배열의 값을 검사 합니다. 제공된 동안 리소스의 콘텐츠가 삭제된 경우 현재 콘텐츠는 정의되지 않습니다. 따라서 리소스를 사용하기 전에 리소스의 콘텐츠를 덮어써야 합니다.
공유 리소스를 회수하려면 공유 디바이스 중 하나에서만 ReclaimResources 를 호출합니다. 리소스에 대한 단독 액세스를 보장하려면 IDXGIKeyedMutex 개체를 사용한 다음, 뮤텍스를 보유하는 동안에만 ReclaimResources 를 호출해야 합니다.
Windows 7용 플랫폼 업데이트: 런타임은 ReclaimResources 가 공유되지 않은 리소스에서 올바르게 사용되었지만 의도한 기능을 수행하지 않는지 확인합니다. Windows 7용 플랫폼 업데이트에 대한 자세한 내용은 Windows 7용 플랫폼 업데이트를 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2012 및 Windows Server 2008 R2용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | dxgi1_2.h |
| 라이브러리 | Dxgi.lib |