DXGKARG_ACQUIRESWIZZLINGRANGE 结构 (d3dkmddi.h)

项目
02/23/2024

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

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

[in] RangeId

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

[in] SegmentId

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

[in] RangeSize

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

[in/out] CPUTranslatedAddress

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