DXGKARG_OPENALLOCATION 구조체(d3dkmddi.h)

아티클
08/07/2023

DXGKARG_OPENALLOCATION 구조는 디스플레이 미니포트 드라이버가 열어야 하는 할당을 설명합니다.

구문

typedef struct _DXGKARG_OPENALLOCATION {
  [in]     UINT                     NumAllocations;
  [in/out] DXGK_OPENALLOCATIONINFO  *pOpenAllocation;
  [in]     VOID                     *pPrivateDriverData;
  [in]     UINT                     PrivateDriverSize;
  [in]     DXGK_OPENALLOCATIONFLAGS Flags;
  [in]     UINT                     SubresourceIndex;
  [out]    SIZE_T                   SubresourceOffset;
  [out]    UINT                     Pitch;
} DXGKARG_OPENALLOCATION;

멤버

[in] NumAllocations

pOpenAllocation 멤버가 지정하는 배열의 요소 수로, 열려는 디바이스별 할당 수를 나타냅니다.

[in/out] pOpenAllocation

열려는 할당에 대한 DXGK_OPENALLOCATIONINFO 구조의 배열입니다.

[in] pPrivateDriverData

사용자 모드 디스플레이 드라이버에서 디스플레이 미니포트 드라이버로 전달되는 개인 데이터 블록에 대한 포인터입니다. 이 프라이빗 데이터 블록은 DxgkDdiCreateAllocation 함수에 대한 호출에서 DXGKARG_CREATEALLOCATION 구조체의 pPrivateDriverData 멤버에 전달되는 것과 동일한 리소스별 데이터입니다. 디스플레이 미니포트 드라이버는 이 개인 데이터 블록을 수정할 수 없습니다.

[in] PrivateDriverSize

pPrivateDriverData가 가리키는 개인 데이터 블록의 크기(바이트)입니다.

[in] Flags

할당에 대해 수행할 작업을 식별하는 DXGK_OPENALLOCATIONFLAGS 구조체입니다.

[in] SubresourceIndex

Windows 8 부터 지원합니다.

렌더링 대상 화면의 리소스에 대한 인덱스입니다.

운영 체제는 디스플레이 미니포트 드라이버가 GDI 하드웨어 가속을 지원하는 경우에만 이 멤버를 지정합니다. 특히 디스플레이 미니포트 드라이버는 DxgkDdiRenderKm 함수를 구현해야 하며 DXGKARG_CREATEDEVICEGdiDevice 멤버가 설정된 디바이스를 만들어야 합니다. 플래그.

SubresourceIndex 값이 할당의 하위 리소스 수보다 크면 디스플레이 미니포트 드라이버에서 오류를 반환해야 합니다.

[out] SubresourceOffset

Windows 8 부터 지원합니다.

할당 시작부터 하위 리소스 시작까지의 오프셋(바이트)입니다.

[out] Pitch

Windows 8 부터 지원합니다.

할당의 피치(바이트), 즉 다음 행의 시작까지의 거리(바이트)입니다.