Compartilhar via


Método IDXGIDevice::QueryResourceResidency (dxgi.h)

Obtém o status de residência de uma matriz de recursos.

Sintaxe

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

Parâmetros

[in] ppResources

Tipo: IUnknown*

Uma matriz de interfaces IDXGIResource .

[out] pResidencyStatus

Tipo: DXGI_RESIDENCY*

Uma matriz de sinalizadores DXGI_RESIDENCY . Cada elemento descreve o status de residência para o elemento correspondente na matriz de argumentos ppResources.

NumResources

Tipo: UINT

O número de recursos na matriz de argumentos ppResources e na matriz de argumentos pResidencyStatus .

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, retorna DXGI_ERROR_DEVICE_REMOVED, E_INVALIDARG ou E_POINTER (consulte Valores HRESULT comuns e WinError.h para obter mais informações).

Comentários

As informações retornadas pela matriz de argumentos pResidencyStatus descrevem o status de residência no momento em que o método QueryResourceResidency foi chamado.

Nota O status de residência mudará constantemente.
 
Se você chamar o método QueryResourceResidency durante um estado de dispositivo removido, o argumento pResidencyStatus retornará o sinalizador DXGI_RESIDENCY_RESIDENT_IN_SHARED_MEMORY .
Nota Esse método não deve ser chamado de todos os quadros, pois incorre em uma quantidade não trivial de sobrecarga.
 

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho dxgi.h
Biblioteca DXGI.lib

Confira também

DXGI Interfaces

IDXGIDevice