Edit

Share via

D3DKMTReserveGpuVirtualAddress function (d3dkmthk.h)

  • Article

D3DKMTReserveGpuVirtualAddress reserves an address range in the current process graphics processing unit (GPU) virtual address space. The address range is only reserved, there is no actual memory behind it.

The driver may choose the base GPU virtual address to use for the reservation by specifying a non-NULL value for BaseAddress. The video memory manager will use the specified range if it is available. If the range intersects with an existing range, the operation will fail. The driver may pass a NULL value in the BaseAddress member to let the video memory manager pick a base address.

When the driver chooses to let the video memory manager pick a base address for the GPU virtual address range, it may choose to constrain the range that the video memory manager will consider by specifying non-NULL values for MinimumAddress and MaximumAddress. The video memory manager will ensure that the allocated GPU virtual address range is entirely contained in the range. The driver may specify only a MinimumAddress and the driver will infer the MaximumAddress is the end of the address space. If only a MaximumAddress is specified, the MinimumAddress is inferred to be 0.

Syntax

NTSTATUS D3DKMTReserveGpuVirtualAddress(
  D3DDDI_RESERVEGPUVIRTUALADDRESS *unnamedParam1
);

Parameters

unnamedParam1

pData [in, out]

A pointer to a D3DDDI_RESERVEGPUVIRTUALADDRESS structure that describes the operation.

Return value

Return code Description
STATUS_SUCCESS The device context was successfully created.
STATUS_INVALID_PARAMETER Parameters were validated and determined to be incorrect.

This function might also return other NTSTATUS values.

Requirements

Requirement Value
Minimum supported client Windows 10
Minimum supported server Windows Server 2016
Target Platform Universal
Header d3dkmthk.h (include D3dkmthk.h)
Library Gdi32.lib
DLL Gdi32.dll