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)

See also

DXGKCB_CREATECONTEXTALLOCATION

DXGKCB_MAPCONTEXTALLOCATION