IDXGIDevice::QueryResourceResidency 方法 (dxgi.h)

取得資源陣列的落地狀態。

語法

HRESULT QueryResourceResidency(
  [in]  IUnknown       * const *ppResources,
  [out] DXGI_RESIDENCY *pResidencyStatus,
        UINT           NumResources
);

參數

[in] ppResources

類型: IUnknown*

IDXGIResource 介面的陣列。

[out] pResidencyStatus

類型: DXGI_RESIDENCY*

DXGI_RESIDENCY旗標的陣列。 每個元素都會描述 ppResources 自變數陣列中對應元素的落地狀態。

NumResources

類型: UINT

ppResources 自變數陣列和 pResidencyStatus 自變數陣列中的資源數目。

傳回值

類型: HRESULT

如果成功,則傳回S_OK;否則,傳回 DXGI_ERROR_DEVICE_REMOVED、E_INVALIDARG或E_POINTER (如需) 詳細資訊,請參閱 Common HRESULT Values 和 WinError.h。

備註

pResidencyStatus 自變數陣列所傳回的資訊描述呼叫 QueryResourceResidency 方法時的落地狀態。

注意 落地狀態會不斷變更。
 
如果您在裝置移除狀態期間呼叫 QueryResourceResidency 方法, pResidencyStatus 自變數會傳回 DXGI_RESIDENCY_RESIDENT_IN_SHARED_MEMORY 旗標。
注意 此方法不應該呼叫每個畫面,因為它會產生非簡單的額外負荷。
 

規格需求

需求
目標平台 Windows
標頭 dxgi.h
程式庫 DXGI.lib

另請參閱

DXGI 介面

IDXGIDevice