Export (0) Print
Expand All
Expand Minimize

DXGKARG_ACQUIRESWIZZLINGRANGE structure

The DXGKARG_ACQUIRESWIZZLINGRANGE structure describes parameters for making an allocation accessible through a CPU aperture.

Syntax


typedef struct _DXGKARG_ACQUIRESWIZZLINGRANGE {
  HANDLE           hAllocation;
  UINT             PrivateDriverData;
  UINT             RangeId;
  UINT             SegmentId;
  SIZE_T           RangeSize;
  PHYSICAL_ADDRESS CPUTranslatedAddress;
} DXGKARG_ACQUIRESWIZZLINGRANGE;

Members

hAllocation

[in] A handle to the allocation that the display miniport driver assigned and that is returned through its DxgkDdiCreateAllocation function.

PrivateDriverData

[in] A UINT value of private data that the user-mode display driver sends when it calls the Microsoft Direct3D runtime's pfnLockCb function. The private data should be an index that lets the display miniport driver determine the accessible part of the allocation (for example, the MIP level). This member should not contain a pointer.

RangeId

[in] The zero-based identifier of the swizzling range that the DxgkDdiAcquireSwizzlingRange function programs.

SegmentId

[in] The identifier of a segment in which the allocation is currently paged.

RangeSize

[in] The size, in bytes, of the range to acquire. This range size is identical to the size of the allocation that DxgkDdiAcquireSwizzlingRange acquires a range for. The driver can modify the value in RangeSize when the UseAlternateVA bit-field flag is specified in the Flags member of the D3DDDICB_LOCKFLAGS structure in a call to the pfnLockCb function. If the UseAlternateVA flag is not specified, the driver cannot change RangeSize.

CPUTranslatedAddress

[in/out] The base physical address where the CPU should map the allocation. The display miniport driver must set this information when a call to its DxgkDdiAcquireSwizzlingRange function succeeds.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dkmddi.h (include D3dkmddi.h)

See also

D3DDDICB_LOCKFLAGS
DxgkDdiAcquireSwizzlingRange
DxgkDdiCreateAllocation
pfnLockCb

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft