Edit

DXGI_DDI_ARG_QUERYRESOURCERESIDENCY structure (dxgiddi.h)

  • Article

The DXGI_DDI_ARG_QUERYRESOURCERESIDENCY structure describes the residency status of a list of resources.

Syntax

typedef struct DXGI_DDI_ARG_QUERYRESOURCERESIDENCY {
  [in]  DXGI_DDI_HDEVICE         hDevice;
  [in]  const DXGI_DDI_HRESOURCE *pResources;
  [out] DXGI_DDI_RESIDENCY       *pStatus;
  [in]  SIZE_T                   Resources;
} DXGI_DDI_ARG_QUERYRESOURCERESIDENCY;

Members

[in] hDevice

A handle to the display device (graphics context) on which the driver determines resource residency status. The Direct3D runtime passes this handle to the driver in the hDrvDevice member of the D3D10DDIARG_CREATEDEVICE structure when the runtime calls the driver's CreateDevice(D3D10) function to create the display device.

[in] pResources

An array of handles to the resources to query for residency on.

[out] pStatus

A pointer to an array of DXGI_DDI_RESIDENCY values. The number of elements in the array is specified by the Resources member, and each element receives one of the following values to indicate the residency status of the corresponding resource in the array that pResources specifies.

Value Meaning
DXGI_DDI_RESIDENCY_FULLY_RESIDENT (1) The resources reside in GPU memory, which is the highest residency status.
DXGI_DDI_RESIDENCY_RESIDENT_IN_SHARED_MEMORY (2) The resources reside in shared memory.
DXGI_DDI_RESIDENCY_EVICTED_TO_DISK (3) The resources are nonresident, which is the lowest residency status.

[in] Resources

The number of elements in the pResources and pStatus arrays.

Requirements

Requirement Value
Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Header dxgiddi.h (include D3d10umddi.h)

See also

QueryResourceResidencyDXGI