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;
[in] const D3DKMT_HANDLE *phAllocationList;
[in] UINT AllocationCount;
[out] D3DKMT_ALLOCATIONRESIDENCYSTATUS *pResidencyStatus;
} 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.
[in] phAllocationList
An array of D3DKMT_HANDLE data types that represent kernel-mode handles to the allocations. The OpenGL ICD uses these handles to query for residency status.
If the OpenGL ICD sets the handle in the hResource member to a non-NULL value, it must set phAllocationList to NULL.
[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.
[out] pResidencyStatus
A pointer to an array of D3DKMT_ALLOCATIONRESIDENCYSTATUS enumerators. If the hResource member is non-NULL, the array contains a single element and receives one of the enumerators that are listed in the following table to indicate the residency status of the resource. If hResource is NULL, the number of elements in the array is specified by the AllocationCount member, and each element receives one of the following enumerators to indicate the residency status of the corresponding allocation in the phAllocationList array.
| Enumerator | Meaning |
|---|---|
| D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) | The resource or allocation resides in GPU memory. |
| D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) | The resource or allocation resides in shared memory. |
| D3DKMT_ALLOCATIONRESIDENCYSTATUS_NOTRESIDENT (3) | The resource or allocation is nonresident. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Header | d3dkmthk.h (include D3dkmthk.h) |