DXGKARGCB_CREATECONTEXTALLOCATION 구조체(d3dkmddi.h)

아티클
03/08/2023

DXGKARGCB_CREATECONTEXTALLOCATION 구조에는 DXGKCB_CREATECONTEXTALLOCATION 콜백 함수에 사용되는 GPU 컨텍스트 또는 디바이스별 컨텍스트의 할당 특성이 포함되어 있습니다.

구문

typedef struct _DXGKARGCB_CREATECONTEXTALLOCATION {
  [in]  DXGK_CREATECONTEXTALLOCATIONFLAGS ContextAllocationFlags;
  [in]  HANDLE                            hAdapter;
  [in]  HANDLE                            hDevice;
  [in]  HANDLE                            hContext;
  [in]  HANDLE                            hDriverAllocation;
  [in]  SIZE_T                            Size;
  [in]  UINT                              Alignment;
  [in]  UINT                              SupportedSegmentSet;
  [in]  UINT                              EvictionSegmentSet;
  [in]  DXGK_SEGMENTPREFERENCE            PreferredSegment;
  [in]  DXGK_SEGMENTBANKPREFERENCE        HintedBank;
  [in]  DXGK_ALLOCATIONINFOFLAGS          Flags;
  [out] HANDLE                            hAllocation;
  [in]  UINT                              PhysicalAdapterIndex;
} DXGKARGCB_CREATECONTEXTALLOCATION;

멤버

[in] ContextAllocationFlags

할당의 속성을 지정하는 DXGK_CREATECONTEXTALLOCATIONFLAGS 구조체입니다.

[in] hAdapter

컨텍스트 할당이 생성되는 그래픽 어댑터에 대한 핸들입니다.

[in] hDevice

원래 DirectX 그래픽 하위 시스템에 의해 디스플레이 미니포트 드라이버의 DxgkDdiCreateDevice 함수에 전달된 디스플레이 디바이스에 대한 핸들입니다.

참고

이 멤버는 시스템 디바이스에 대해 NULL로 설정됩니다.

[in] hContext

ContextAllocationFlags.SharedAcrossContexts가 값 0으로 설정된 경우 이 멤버는 DXGKCB_CREATECONTEXTALLOCATION 함수에 전달된 컨텍스트에 대해 DirectX 그래픽 하위 시스템에 의해 할당된 값을 포함합니다.

ContextAllocationFlags.SharedAcrossContexts가 값 1로 설정된 경우 이 멤버를 NULL로 설정해야 합니다.

참고

또한 이 멤버는 시스템 컨텍스트에 대해 NULL로 설정됩니다.

[in] hDriverAllocation

생성된 할당을 식별하는 디스플레이 미니포트 드라이버에서 만든 핸들입니다. 이 멤버의 값은 이후에 DxgkDdiBuildPagingBuffer 함수의 pBuildPagingBuffer 매개 변수가 가리키는 DXGKARG_BUILDPAGINGBUFFER 구조체의 Transfer.hAllocation 멤버로 전달됩니다.

[in] Size

할당에 필요한 크기(바이트)입니다.

[in] Alignment

할당에 필요한 맞춤(바이트)입니다.

[in] SupportedSegmentSet

디스플레이 미니포트 드라이버가 읽기 또는 쓰기 작업을 위해 PreferredSegment 멤버에서 설정할 수 있는 세그먼트 식별자입니다.

[in] EvictionSegmentSet

제거에 사용할 수 있는 세그먼트의 식별자입니다.

[in] PreferredSegment

디스플레이 미니포트 드라이버가 비디오 메모리 관리자가 할당을 페이지 인하는 데 사용하는 것을 요청하는 기본 세그먼트 식별자를 나타내는 DXGK_SEGMENTPREFERENCE 구조체입니다.

[in] HintedBank

디스플레이 미니포트 드라이버가 비디오 메모리 관리자가 할당을 페이징하는 데 사용하는 것을 요청하는 은행 주문 기본 설정을 나타내는 DXGK_SEGMENTBANKPREFERENCE 구조입니다.

[in] Flags

비트 필드 플래그에서 할당에 대한 속성을 식별하는 DXGK_ALLOCATIONINFOFLAGS 구조체입니다. 이러한 속성은 만들 할당 유형을 나타냅니다. 디스플레이 미니포트 드라이버는 비디오 메모리 관리자에 대해 이러한 플래그를 지정합니다. 플래그 값에 대한 제한 사항은 비고를 참조하세요.

[out] hAllocation

DirectX 그래픽 하위 시스템이 할당에 할당한 핸들입니다. 이 값은 이후에 DXGKCB_DESTROYCONTEXTALLOCATION 함수의 hAllocation 매개 변수로 전달됩니다.

[in] PhysicalAdapterIndex

실제 어댑터의 인덱스입니다. 이 필드는 WDDM 2.0부터 사용할 수 있습니다.

설명

디스플레이 미니포트 드라이버는 DXGKCB_CREATECONTEXTALLOCATION 호출하여 GPU 컨텍스트 또는 디바이스별 컨텍스트를 할당합니다. 드라이버가 이 함수를 호출하면 ContextAllocation 매개 변수를 통해 DXGKARGCB_CREATECONTEXTALLOCATION 구조체에 대한 포인터를 전달합니다.