DXGKARG_ACQUIRESWIZZLINGRANGE结构（d3dkmddi.h）

项目
02/06/2025

DXGKARG_ACQUIRESWIZZLINGRANGE结构描述用于通过 CPU 光圈访问分配的参数。

语法

typedef struct _DXGKARG_ACQUIRESWIZZLINGRANGE {
  [in]     HANDLE           hAllocation;
  [in]     UINT             PrivateDriverData;
  [in]     UINT             RangeId;
  [in]     UINT             SegmentId;
  [in]     SIZE_T           RangeSize;
  [in/out] PHYSICAL_ADDRESS CPUTranslatedAddress;
} DXGKARG_ACQUIRESWIZZLINGRANGE;

成员

[in] hAllocation

显示微型端口驱动程序分配并通过其 DxgkDdiCreateAllocation 函数返回的分配句柄。

[in] PrivateDriverData

用户模式显示驱动程序在调用 direct3D 运行时的 Microsoft pfnLockCb 函数时发送的专用数据的 UINT 值。专用数据应该是一个索引，允许显示微型端口驱动程序确定分配的可访问部分（例如 MIP 级别）。此成员不应包含指针。

[in] RangeId

DxgkDdiAcquireSwizzlingRange 函数程序的重排范围的从零开始的标识符。

[in] SegmentId

分配当前分页的段的标识符。

[in] RangeSize

要获取的范围的大小（以字节为单位）。此范围大小与 DxgkDdiAcquireSwizzlingRange 获取范围的分配大小相同。当调用 pfnLockCb 函数时，驱动程序可以在 RangeSize 中修改 UseAlternateVA 位字段标志中指定的标志D3DDDICB_LOCKFLAGS 成员中的值。如果未指定 UseAlternateVA 标志，驱动程序将无法更改 rangeSize 。

[in/out] CPUTranslatedAddress

CPU 应映射分配的基物理地址。当调用其 DxgkDdiAcquireSwizzlingRange 函数时，显示微型端口驱动程序必须设置此信息。