D3DKMT_QUERYALLOCATIONRESIDENCY structure (d3dkmthk.h)

The D3DKMT_QUERYALLOCATIONRESIDENCY structure describes information for retrieving the residency status from a resource or list of allocations.

Syntax

typedef struct _D3DKMT_QUERYALLOCATIONRESIDENCY {
  [in]  D3DKMT_HANDLE hDevice;
  [in]  D3DKMT_HANDLE hResource;
  void          D3DKMT_PTR(
    const D3DKMT_HANDLE *unnamedParam1,
    phAllocationList    unnamedParam2
  );
  [in]  UINT          AllocationCount;
  void          D3DKMT_PTR(
    D3DKMT_ALLOCATIONRESIDENCYSTATUS *unnamedParam1,
    pResidencyStatus                 unnamedParam2
  );
} D3DKMT_QUERYALLOCATIONRESIDENCY;

Members

[in] hDevice

A D3DKMT_HANDLE data type that represents a kernel-mode handle to the device that the resource or list of allocations are associated with.

[in] hResource

A handle to a resource whose residency is queried. If the OpenGL ICD uses the array that phAllocationList specifies to query for residency, it sets hResource to NULL. If the OpenGL ICD sets hResource to a non-NULL value, it must set the AllocationCount member to zero and phAllocationList to NULL.

If hResource is non-NULL, all of the allocations that belong to the resource are queried, and the result is returned in the first element of the array that pResidencyStatus points to.

If any allocation that belongs to the resource is not resident, the entire resource is considered not resident.

To retrieve detailed residency information about each allocation that belongs to a resource, the allocation must be queried.

void D3DKMT_PTR( const D3DKMT_HANDLE *unnamedParam1, phAllocationList unnamedParam2)

[in] AllocationCount

The number of allocations in the array that phAllocationList specifies. If the OpenGL ICD sets the handle in the hResource member to a non-NULL value, it must set AllocationCount to zero.

void D3DKMT_PTR( D3DKMT_ALLOCATIONRESIDENCYSTATUS *unnamedParam1, pResidencyStatus unnamedParam2)

Requirements

Requirement Value
Minimum supported client Windows Vista
Header d3dkmthk.h (include D3dkmthk.h)

See also

D3DKMTQueryAllocationResidency