DXGKARG_ACQUIRESWIZZLINGRANGE 結構 (d3dkmddi.h)

發行項
02/26/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 函式程式之 Swizzling 範圍之以零起始的標識符。

[in] SegmentId

目前分頁配置之區段的標識碼。

[in] RangeSize

要取得的範圍大小，以位元組為單位。此範圍大小與 DxgkDdiAcquireSwizzlingRange 取得範圍的配置大小相同。當UseAlternateVA位字段旗標是在呼叫 pfnLockCb 函式時，驅動程式可以在呼叫 pfnLockCb 函式時，於 D3DDDICB_LOCKFLAGS 結構的 Flags 成員中指定時，修改 RangeSize 中的值。如果未指定 UseAlternateVA 旗標，驅動程式就無法變更 RangeSize。

[in/out] CPUTranslatedAddress

CPU 應該對應配置所在的基底實體位址。當呼叫其 DxgkDdiAcquireSwizzlingRange 函式成功時，顯示迷你埠驅動程式必須設定這項資訊。