DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY 구조체(dxgiddi.h)

아티클
02/26/2024

콘텐츠가 복사되는 다중 평면 오버레이 할당에 대해 설명합니다.

구문

typedef struct DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY {
  [in] void                                       *pDXGIContext;
  [in] HANDLE                                     hContext;
  [in] UINT                                       BroadcastContextCount;
       HANDLE                                     BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
  [in] DWORD                                      AllocationInfoCount;
       DXGIDDI_MULTIPLANE_OVERLAY_ALLOCATION_INFO AllocationInfo[DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS];
} DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY;

멤버

[in] pDXGIContext

Microsoft DXGI(DirectX Graphics Infrastructure) 컨텍스트에 대한 핸들입니다. 이 핸들은 드라이버에 불투명합니다. 드라이버는 드라이버가 해당 pfnPresentMultiplaneOverlay(DXGI) 함수에 대한 호출에서 받은 DXGI_DDI_ARG_PRESENTMULTIPLANEOVERLAY 구조체의 pDXGIContext 멤버에서 핸들을 이 멤버에 할당해야 합니다.

[in] hContext

드라이버가 복사 작업을 제출하는 컨텍스트에 대한 핸들입니다. 사용자 모드 표시 드라이버는 이전에 pfnCreateContextCb 함수를 호출하여 이 컨텍스트를 만들었습니다.

[in] BroadcastContextCount

BroadcastContext 멤버가 지정하는 배열의 추가 컨텍스트 수입니다.

[in] BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

현재 작업을 브로드캐스트할 추가 컨텍스트에 대한 핸들 배열입니다. 64로 정의된 D3DDDI_MAX_BROADCAST_CONTEXT 상수는 사용자 모드 표시 드라이버가 현재 작업을 브로드캐스트할 수 있는 최대 추가 컨텍스트 수를 정의합니다.

브로드캐스트는 대칭 이동 작업에 대해서만 지원됩니다. 대칭 이동 작업을 브로드캐스트하려면 디스플레이 미니포트 드라이버가 MMIO(메모리 매핑 I/O) 기반 대칭 이동을 지원해야 합니다. MMIO 대칭 이동 지원을 나타내기 위해 디스플레이 미니포트 드라이버는 DxgkDdiQueryAdapterInfo 함수가 호출되면 DXGK_DRIVERCAPS 구조체의 FlipCaps 멤버에 FlipOnVSyncMmIo 비트 필드 플래그를 설정합니다.

hContext 멤버가 지정하고 사용자 모드 표시 드라이버가 표시하는 원래 컨텍스트는 BroadcastContext 배열의 요소가 아닙니다. 예를 들어 BroadcastContext 배열에 하나의 요소가 포함된 경우 사용자 모드 표시 드라이버는 현재 작업을 소유 컨텍스트(hContext)로 보내고 해당 하나의 추가 컨텍스트로 브로드캐스트합니다.

[in] AllocationInfoCount

AllocationInfo 멤버가 지정하는 배열의 할당 수입니다. 최대 수는 16이며 DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS 상수의 값입니다.

AllocationInfo[DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS]

다중 평면 오버레이 할당에 대한 정보를 지정하는 형식 DXGIDDI_MULTIPLANE_OVERLAY_ALLOCATION_INFO 구조체의 배열입니다.