DXGKARGCB_MAPCONTEXTALLOCATION structure (d3dkmddi.h)
The DXGKARGCB_MAPCONTEXTALLOCATION structure contains the arguments used in the DXGKCB_MAPCONTEXTALLOCATION callback function, to map a graphics processing unit (GPU) virtual address to the specified context allocation.
Syntax
typedef struct _DXGKARGCB_MAPCONTEXTALLOCATION {
[in] D3DGPU_VIRTUAL_ADDRESS BaseAddress;
[in] D3DGPU_VIRTUAL_ADDRESS MinimumAddress;
[in] D3DGPU_VIRTUAL_ADDRESS MaximumAddress;
[in] HANDLE hAllocation;
[in] D3DGPU_SIZE_T OffsetInPages;
[in] D3DGPU_SIZE_T SizeInPages;
[in] D3DDDIGPUVIRTUALADDRESS_PROTECTION_TYPE Protection;
[in] UINT64 DriverProtection;
} DXGKARGCB_MAPCONTEXTALLOCATION;
Members
[in] BaseAddress
(optional) If non-NULL, the video memory manager will attempt to use this address as the base address for the mapping. If the range from BaseAddress to BaseAddress+Size isn’t free, the call will fail. When this parameter is non-NULL, MinimumAddress and MaximumAddress are ignored.
If NULL is specified, the video memory manager will pick the base address for the allocation within the specified MinimumAddress and MaximumAddress.
[in] MinimumAddress
(optional) The minimum GPU virtual address to consider for the mapped range. This parameter is ignored when BaseAddress != NULL.
[in] MaximumAddress
The maximum GPU virtual address to consider for the mapped range. The video memory manager will guarantee that BaseAddress+Size <= MaximumAddress. If this is set to NULL the video memory manager will not apply any limit. This parameter is ignored when BaseAddress != NULL.
[in] hAllocation
Handle to the allocation being mapped into the GPU virtual address space. This is a DirectX graphics kernel handle, returned by DXGKCB_CREATECONTEXTALLOCATION.
[in] OffsetInPages
The offset, in 4KB pages, to the starting page within the specified allocation that must be mapped.
[in] SizeInPages
The size of the range to map in number of 4KB pages.
[in] Protection
The protection on the GPU virtual address that is mapped.
[in] DriverProtection
The driver protection parameters.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10 (WDDM 2.0) |
| Minimum supported server | Windows Server 2016 |
| Header | d3dkmddi.h (include D3dkmddi.h) |