D3DDDI_UPDATEGPUVIRTUALADDRESS_OPERATION structure (d3dukmdt.h)
D3DDDI_UPDATEGPUVIRTUALADDRESS_OPERATION describes a virtual address update operation.
Syntax
typedef struct _D3DDDI_UPDATEGPUVIRTUALADDRESS_OPERATION {
D3DDDI_UPDATEGPUVIRTUALADDRESS_OPERATION_TYPE OperationType;
union {
struct {
D3DKMT_ALIGN64 D3DGPU_VIRTUAL_ADDRESS BaseAddress;
D3DKMT_ALIGN64 D3DGPU_SIZE_T SizeInBytes;
D3DKMT_HANDLE hAllocation;
D3DKMT_ALIGN64 D3DGPU_SIZE_T AllocationOffsetInBytes;
D3DKMT_ALIGN64 D3DGPU_SIZE_T AllocationSizeInBytes;
} Map;
struct {
D3DKMT_ALIGN64 D3DGPU_VIRTUAL_ADDRESS BaseAddress;
D3DKMT_ALIGN64 D3DGPU_SIZE_T SizeInBytes;
D3DKMT_HANDLE hAllocation;
D3DKMT_ALIGN64 D3DGPU_SIZE_T AllocationOffsetInBytes;
D3DKMT_ALIGN64 D3DGPU_SIZE_T AllocationSizeInBytes;
D3DDDIGPUVIRTUALADDRESS_PROTECTION_TYPE Protection;
D3DKMT_ALIGN64 UINT64 DriverProtection;
} MapProtect;
struct {
D3DKMT_ALIGN64 D3DGPU_VIRTUAL_ADDRESS BaseAddress;
D3DKMT_ALIGN64 D3DGPU_SIZE_T SizeInBytes;
D3DDDIGPUVIRTUALADDRESS_PROTECTION_TYPE Protection;
} Unmap;
struct {
D3DKMT_ALIGN64 D3DGPU_VIRTUAL_ADDRESS SourceAddress;
D3DKMT_ALIGN64 D3DGPU_SIZE_T SizeInBytes;
D3DKMT_ALIGN64 D3DGPU_VIRTUAL_ADDRESS DestAddress;
} Copy;
};
} D3DDDI_UPDATEGPUVIRTUALADDRESS_OPERATION;
Members
OperationType
Map
Maps the given virtual address range to the given allocation range. The allocation does not have to be resident at the time of submission or at the time of mapping. The read-write protection is set to the pages. DriverProtection for the pages is set to zero.
Map.BaseAddress
Specifies the BaseAddress of the GPU virtual address range to update. The value is in bytes and must be 4KB aligned.
The entire range from BaseAddress to BaseAddress+SizeInBytes must be in the reserved (zero) or mapped state, or the pfnUpdateGpuVirtualAddressCb operation will fail. The virtual address ranges for all operations must belong to a virtual address range which is reserved by the same pfnReserveGpuVirtualAddressCb call.
Map.SizeInBytes
Specifies the size, in bytes, for the range being updated. The value must be 4KB aligned.
Map.hAllocation
Specifies the allocation the range needs to be mapped to.
Map.AllocationOffsetInBytes
Specifies the offset, in bytes, to the first page in the allocation to map. The value must be 4KB aligned.
Map.AllocationSizeInBytes
Specifies the size of the allocation range to map, in bytes. The value must be 4KB aligned and must be less than Map.SizeInBytes. If this value is zero, Map.SizeInBytes is used.
When this value is than Map.SizeInBytes, Map.SizeInBytes must be a multiple of it. In this case Map.SizeInBytes/Map.AllocationSizeInBytes virtual address ranges will be mapped to the same allocation range.
MapProtect
Maps the given virtual address range to the given allocation range. The allocation does not have to be resident at the time of submission or at the time of mapping. The page protection is specified in the operation.
MapProtect.BaseAddress
Specifies the BaseAddress of the GPU virtual address range to update. The value is in bytes and must be 4KB aligned.
The entire range from BaseAddress to BaseAddress+SizeInBytes must be in the reserved (zero) or mapped state, or pfnUpdateGpuVirtualAddressCb will fail. The virtual address ranges for all operations must belong to a virtual address range which is reserved by the same pfnReserveGpuVirtualAddressCb call.
MapProtect.SizeInBytes
Specifies the size, in bytes, for the range being updated. The value must be 4KB aligned.
MapProtect.hAllocation
Specifies the allocation the range needs to be mapped to.
MapProtect.AllocationOffsetInBytes
Specifies the offset, in bytes, to the first page in the allocation to map. The value must be 4KB aligned.
MapProtect.AllocationSizeInBytes
Specifies the size of the allocation range to map, in bytes. The value must be 4KB aligned and must be less than Map.SizeInBytes. If this value is zero, Map.SizeInBytes is used.
When this value is less than Map.SizeInBytes, Map.SizeInBytes must be a multiple of it. In this case Map.SizeInBytes/Map.AllocationSizeInBytes virtual address ranges will be mapped to the same allocation range.
MapProtect.Protection
Specifies API defined protection for the pages.
MapProtect.DriverProtection
Specifies driver specific protection for the pages.
Unmap
Puts the specified virtual address range to the zero state or to the invalid state.
Unmap.BaseAddress
Specifies the BaseAddress of the GPU virtual address range to put back into the zero state. The value is in bytes and must be 4KB aligned.
Unmap.SizeInBytes
Specifies the size, in bytes, for the range to be freed. The value must be 4KB aligned.
Unmap.Protection
Defines is the page table entry state after un-mapping, either Zero or NoAccess.
Copy
The copy operation copies all mappings from source GPU virtual address range to the destination range. The source and destination ranges are allowed to intersect. Both ranges must belong to a reserved (zero) virtual address range.
BaseAddress
Specifies the start virtual address of the source virtual address range. The value is in bytes and must be 4KB aligned.
Copy.SourceAddress
Copy.SizeInBytes
Specifies the size, in bytes, for the range being copied. The value must be 4KB aligned.
Copy.DestAddress
Specifies the start virtual address of the destination virtual address range. The value is in bytes and must be 4KB aligned.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10 |
| Minimum supported server | Windows Server 2016 |
| Header | d3dukmdt.h (include D3dumddi.h, D3dkmddi.h) |