DXGK_BUILDPAGINGBUFFER_NOTIFYRESIDENCY structure (d3dkmddi.h)
DXGK_BUILDPAGINGBUFFER_NOTIFYRESIDENCY describes a residency allocation change operation.
Syntax
typedef struct _DXGK_BUILDPAGINGBUFFER_NOTIFYRESIDENCY {
HANDLE hAllocation;
D3DGPU_PHYSICAL_ADDRESS PhysicalAddress;
union {
UINT Resident : 1;
UINT Reserved : 31;
};
} DXGK_BUILDPAGINGBUFFER_NOTIFYRESIDENCY;
Members
hAllocation
The kernel mode driver handle returned from DxgkDdiCreateAllocation.
PhysicalAddress
The physical address of the allocation. The physical address (0, 0) is invalid and is used when the allocation is being evicted.
Resident
Set to 0 when the allocation is evicted and set to 1 when the allocation is committed.
Reserved
This member is not used and should be set to zero.
Remarks
The paging operations is issued only for allocations, for which the kernel mode driver sets the DXGK_ALLOCATIONINFOFLAGS::ExplicitResidencyNotification and AccessedPhysically flags.
The operation is issued after FillVirtual or TransferVirtual operations when the allocation is committed to a memory segment (Resident == 1). Note that the previous paging operations might not yet be finished by graphics processing unit (GPU).
The operation is issued before TransferVirtual operation when the allocation is evicted (Resident == 0) from a memory segment.
Note that the NotifyResidency operation will be issued only once during allocation eviction/commitment, while there might be several TransferVirtual/FillVirtual operations for a single allocation.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10 |
| Minimum supported server | Windows Server 2016 |
| Header | d3dkmddi.h (include D3dkmddi.h) |