DXGI_DDI_ARG_PRESENT1 구조체(dxgiddi.h)
표시할 리소스에 대해 설명합니다. WDDM(Windows Display Driver Model) 1.3 이상 사용자 모드 디스플레이 드라이버에서 pfnPresent1(DXGI) 함수와 함께 사용됩니다.
구문
typedef struct DXGI_DDI_ARG_PRESENT1 {
[in] DXGI_DDI_HDEVICE hDevice;
[in] const DXGI_DDI_ARG_PRESENTSURFACE *phSurfacesToPresent;
[in] UINT SurfacesToPresent;
[in] DXGI_DDI_HRESOURCE hDstResource;
[in] UINT DstSubResourceIndex;
[in] void *pDXGIContext;
[in] DXGI_DDI_PRESENT_FLAGS Flags;
[in] DXGI_DDI_FLIP_INTERVAL_TYPE FlipInterval;
UINT Reserved;
[in] const RECT *pDirtyRects;
[in] UINT DirtyRects;
UINT BackBufferMultiplicity;
} DXGI_DDI_ARG_PRESENT1;
멤버
[in] hDevice
드라이버가 프레젠테이션을 수행하는 디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다. Direct3D 런타임은 런타임이 드라이버의 CreateDevice(D3D10) 함수를 호출하여 디스플레이 디바이스를 만들 때 이 핸들을 D3D10DDIARG_CREATEDEVICE 구조의 hDrvDevice 멤버의 드라이버에 전달합니다.
[in] phSurfacesToPresent
표시하거나 해제할 원본 리소스에 대한 NULL 이 아닌 핸들 및 0부터 시작하는 인덱스의 배열입니다. phSurfacesToPresent 는 항상 표시할 리소스에 대한 유효한 핸들입니다.
[in] SurfacesToPresent
표시할 표면의 배열입니다. 0이 아니어야 합니다.
[in] hDstResource
표시할 대상 리소스에 대한 핸들입니다. 대상을 알 수 없는 경우 hDstResource 는 NULL 일 수 있습니다. 커널 모드는 DMA를 통해 하드웨어 명령 스트림을 그래픽 프로세서로 보내기 직전에 대상을 결정합니다.
많은 리소스가 표시되면 hDstResource 는 NULL이 되고 드라이버는 pfnPresentCb 함수와 함께 사용할 마지막 원본 리소스 핸들만 변환해야 합니다.
[in] DstSubResourceIndex
hDstResource 멤버의 핸들이 지정하는 대상 리소스에 대한 인덱스(0부터 시작)입니다. DstSubResourceIndex 인덱스는 표시할 하위 리소스 또는 표면을 나타냅니다.
[in] pDXGIContext
DXGI 컨텍스트에 대한 핸들입니다. 이 핸들은 드라이버에 불투명합니다. 드라이버가 pfnPresentCbDXGI 함수를 호출할 때 드라이버는 이 멤버의 핸들을 DXGIDDICB_PRESENT 구조체의 pDXGIContext 멤버로 전달해야 합니다.
[in] Flags
비트 필드 플래그에서 현재 작업을 수행하는 방법을 식별하는 DXGI_DDI_PRESENT_FLAGS 구조체입니다.
[in] FlipInterval
대칭 이동 간격(즉, 0, 1, 2, 3 또는 4 세로 동기화 후에 대칭 이동이 발생하는 경우)을 나타내는 DXGI_DDI_FLIP_INTERVAL_TYPE 형식의 값입니다.
Reserved
이 멤버는 예약되어 있으며 0으로 설정해야 합니다.
[in] pDirtyRects
원본 사각형 SrcRect를 기준으로 변경된 오버레이 평면의 부분을 나타내는 RECT(더티 사각형) 배열에 대한 포인터입니다.
드라이버는 이 멤버를 사용하여 최적화를 수행할 수 있지만 더티 사각형 정보를 사용할 필요는 없습니다. 그러나 드라이버는 제공된 더티 사각형을 기반으로 함수 호출을 실패해서는 안 됩니다.
[in] DirtyRects
pDirtyRects가 가리키는 배열의 더티 사각형 수입니다.
BackBufferMultiplicity
논리 백 버퍼당 실제 백 버퍼 수입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8.1,WDDM 1.3 이상 |
| 지원되는 최소 서버 | Windows Server 2012 R2 |
| 머리글 | dxgiddi.h(D3d10umddi.h 포함) |