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 함수가 프로그래밍하는 스위즐링 범위의 0부터 시작하는 식별자입니다.

[in] SegmentId

할당이 현재 페이징된 세그먼트의 식별자입니다.

[in] RangeSize

획득할 범위의 크기(바이트)입니다. 이 범위 크기는 DxgkDdiAcquireSwizzlingRange 가 범위를 획득하는 할당의 크기와 동일합니다. 드라이버는 useAlternateVA 비트 필드 플래그가 pfnLockCb 함수에 대한 호출에서 D3DDDICB_LOCKFLAGS 구조체의 Flags 멤버에 지정된 경우 RangeSize의 값을 수정할 수 있습니다. UseAlternateVA 플래그를 지정하지 않으면 드라이버는 RangeSize를 변경할 수 없습니다.

[in/out] CPUTranslatedAddress

CPU가 할당을 매핑해야 하는 기본 물리적 주소입니다. 디스플레이 미니포트 드라이버는 DxgkDdiAcquireSwizzlingRange 함수에 대한 호출이 성공하면 이 정보를 설정해야 합니다.