← Back to branch summary

~mmach/netext73/mesa-haswell

« back to all changes in this revision

Viewing changes to include/d3dadapter/present.h

  • Committer: mmach
  • Date: 2022-09-22 19:56:13 UTC
  • Revision ID: netbit73@gmail.com-20220922195613-wtik9mmy20tmor0i
2022-09-22 21:17:09

Show diffs side-by-side

added added

removed removed

Lines of Context:
include/d3dadapter/present.h
1
 
/*
2
 
 * Copyright 2011 Joakim Sindholt <opensource@zhasha.com>
3
 
 *
4
 
 * Permission is hereby granted, free of charge, to any person obtaining a
5
 
 * copy of this software and associated documentation files (the "Software"),
6
 
 * to deal in the Software without restriction, including without limitation
7
 
 * on the rights to use, copy, modify, merge, publish, distribute, sub
8
 
 * license, and/or sell copies of the Software, and to permit persons to whom
9
 
 * the Software is furnished to do so, subject to the following conditions:
10
 
 *
11
 
 * The above copyright notice and this permission notice (including the next
12
 
 * paragraph) shall be included in all copies or substantial portions of the
13
 
 * Software.
14
 
 *
15
 
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
 
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
 
 * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
18
 
 * THE AUTHOR(S) AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
19
 
 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
20
 
 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
21
 
 * USE OR OTHER DEALINGS IN THE SOFTWARE. */
22
 
 
23
 
#ifndef _D3DADAPTER_PRESENT_H_
24
 
#define _D3DADAPTER_PRESENT_H_
25
 
 
26
 
#include <d3d9.h>
27
 
 
28
 
#ifndef D3DOK_WINDOW_OCCLUDED
29
 
#define D3DOK_WINDOW_OCCLUDED MAKE_D3DSTATUS(2531)
30
 
#endif /* D3DOK_WINDOW_OCCLUDED */
31
 
 
32
 
#ifndef __cplusplus
33
 
typedef struct ID3DPresent ID3DPresent;
34
 
typedef struct ID3DPresentGroup ID3DPresentGroup;
35
 
typedef struct ID3DAdapter9 ID3DAdapter9;
36
 
typedef struct D3DWindowBuffer D3DWindowBuffer;
37
 
 
38
 
/* Available since version 1.3 */
39
 
typedef struct _D3DPRESENT_PARAMETERS2_ {
40
 
    /* Whether D3DSWAPEFFECT_DISCARD is allowed to release the
41
 
     * D3DWindowBuffers in any order, and eventually with a delay.
42
 
     * FALSE (Default): buffers should be released as soon as possible.
43
 
     * TRUE: it is allowed to release some buffers with a delay, and in
44
 
     * a random order. */
45
 
    BOOL AllowDISCARDDelayedRelease;
46
 
    /* User preference for D3DSWAPEFFECT_DISCARD with D3DPRESENT_INTERVAL_IMMEDIATE.
47
 
     * FALSE (Default): User prefers presentation to occur as soon as possible,
48
 
     * with potential tearings.
49
 
     * TRUE: User prefers presentation to be tear free. Requires
50
 
     * AllowDISCARDDelayedRelease to have any effect. */
51
 
    BOOL TearFreeDISCARD;
52
 
} D3DPRESENT_PARAMETERS2, *PD3DPRESENT_PARAMETERS2, *LPD3DPRESENT_PARAMETERS2;
53
 
 
54
 
/* Presentation backend for drivers to display their brilliant work */
55
 
typedef struct ID3DPresentVtbl
56
 
{
57
 
    /* IUnknown */
58
 
    HRESULT (WINAPI *QueryInterface)(ID3DPresent *This, REFIID riid, void **ppvObject);
59
 
    ULONG (WINAPI *AddRef)(ID3DPresent *This);
60
 
    ULONG (WINAPI *Release)(ID3DPresent *This);
61
 
 
62
 
    /* ID3DPresent */
63
 
    /* This function initializes the screen and window provided at creation.
64
 
     * Hence why this should always be called as the one of first things a new
65
 
     * swap chain does */
66
 
    HRESULT (WINAPI *SetPresentParameters)(ID3DPresent *This, D3DPRESENT_PARAMETERS *pPresentationParameters, D3DDISPLAYMODEEX *pFullscreenDisplayMode);
67
 
    /* Make a buffer visible to the window system via dma-buf fd.
68
 
     * For better compatibility, it must be 32bpp and format ARGB/XRGB */
69
 
    HRESULT (WINAPI *NewD3DWindowBufferFromDmaBuf)(ID3DPresent *This, int dmaBufFd, int width, int height, int stride, int depth, int bpp, D3DWindowBuffer **out);
70
 
    HRESULT (WINAPI *DestroyD3DWindowBuffer)(ID3DPresent *This, D3DWindowBuffer *buffer);
71
 
    /* After presenting a buffer to the window system, the buffer
72
 
     * may be used as is (no copy of the content) by the window system.
73
 
     * You must not use a non-released buffer, else the user may see undefined content.
74
 
     * Note: This function waits as well that the buffer content was displayed (this
75
 
     * can be after the release of the buffer if the window system decided to make
76
 
     * an internal copy and release early. */
77
 
    HRESULT (WINAPI *WaitBufferReleased)(ID3DPresent *This, D3DWindowBuffer *buffer);
78
 
    HRESULT (WINAPI *FrontBufferCopy)(ID3DPresent *This, D3DWindowBuffer *buffer);
79
 
    /* It is possible to do partial copy, but impossible to do resizing, which must
80
 
     * be done by the client after checking the front buffer size */
81
 
    HRESULT (WINAPI *PresentBuffer)(ID3DPresent *This, D3DWindowBuffer *buffer, HWND hWndOverride, const RECT *pSourceRect, const RECT *pDestRect, const RGNDATA *pDirtyRegion, DWORD Flags);
82
 
    HRESULT (WINAPI *GetRasterStatus)(ID3DPresent *This, D3DRASTER_STATUS *pRasterStatus);
83
 
    HRESULT (WINAPI *GetDisplayMode)(ID3DPresent *This, D3DDISPLAYMODEEX *pMode, D3DDISPLAYROTATION *pRotation);
84
 
    HRESULT (WINAPI *GetPresentStats)(ID3DPresent *This, D3DPRESENTSTATS *pStats);
85
 
    HRESULT (WINAPI *GetCursorPos)(ID3DPresent *This, POINT *pPoint);
86
 
    HRESULT (WINAPI *SetCursorPos)(ID3DPresent *This, POINT *pPoint);
87
 
    /* Cursor size is always 32x32. pBitmap and pHotspot can be NULL. */
88
 
    HRESULT (WINAPI *SetCursor)(ID3DPresent *This, void *pBitmap, POINT *pHotspot, BOOL bShow);
89
 
    HRESULT (WINAPI *SetGammaRamp)(ID3DPresent *This, const D3DGAMMARAMP *pRamp, HWND hWndOverride);
90
 
    HRESULT (WINAPI *GetWindowInfo)(ID3DPresent *This,  HWND hWnd, int *width, int *height, int *depth);
91
 
    /* Available since version 1.1 */
92
 
    BOOL (WINAPI *GetWindowOccluded)(ID3DPresent *This);
93
 
    /* Available since version 1.2 */
94
 
    BOOL (WINAPI *ResolutionMismatch)(ID3DPresent *This);
95
 
    HANDLE (WINAPI *CreateThread)(ID3DPresent *This, void *pThreadfunc, void *pParam);
96
 
    BOOL (WINAPI *WaitForThread)(ID3DPresent *This, HANDLE thread);
97
 
    /* Available since version 1.3 */
98
 
    HRESULT (WINAPI *SetPresentParameters2)(ID3DPresent *This, D3DPRESENT_PARAMETERS2 *pParameters);
99
 
    BOOL (WINAPI *IsBufferReleased)(ID3DPresent *This, D3DWindowBuffer *buffer);
100
 
    /* Wait a buffer gets released. */
101
 
    HRESULT (WINAPI *WaitBufferReleaseEvent)(ID3DPresent *This);
102
 
} ID3DPresentVtbl;
103
 
 
104
 
struct ID3DPresent
105
 
{
106
 
    ID3DPresentVtbl *lpVtbl;
107
 
};
108
 
 
109
 
/* IUnknown macros */
110
 
#define ID3DPresent_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
111
 
#define ID3DPresent_AddRef(p) (p)->lpVtbl->AddRef(p)
112
 
#define ID3DPresent_Release(p) (p)->lpVtbl->Release(p)
113
 
/* ID3DPresent macros */
114
 
#define ID3DPresent_GetPresentParameters(p,a) (p)->lpVtbl->GetPresentParameters(p,a)
115
 
#define ID3DPresent_SetPresentParameters(p,a,b) (p)->lpVtbl->SetPresentParameters(p,a,b)
116
 
#define ID3DPresent_NewD3DWindowBufferFromDmaBuf(p,a,b,c,d,e,f,g) (p)->lpVtbl->NewD3DWindowBufferFromDmaBuf(p,a,b,c,d,e,f,g)
117
 
#define ID3DPresent_DestroyD3DWindowBuffer(p,a) (p)->lpVtbl->DestroyD3DWindowBuffer(p,a)
118
 
#define ID3DPresent_WaitBufferReleased(p,a) (p)->lpVtbl->WaitBufferReleased(p,a)
119
 
#define ID3DPresent_FrontBufferCopy(p,a) (p)->lpVtbl->FrontBufferCopy(p,a)
120
 
#define ID3DPresent_PresentBuffer(p,a,b,c,d,e,f) (p)->lpVtbl->PresentBuffer(p,a,b,c,d,e,f)
121
 
#define ID3DPresent_GetRasterStatus(p,a) (p)->lpVtbl->GetRasterStatus(p,a)
122
 
#define ID3DPresent_GetDisplayMode(p,a,b) (p)->lpVtbl->GetDisplayMode(p,a,b)
123
 
#define ID3DPresent_GetPresentStats(p,a) (p)->lpVtbl->GetPresentStats(p,a)
124
 
#define ID3DPresent_GetCursorPos(p,a) (p)->lpVtbl->GetCursorPos(p,a)
125
 
#define ID3DPresent_SetCursorPos(p,a) (p)->lpVtbl->SetCursorPos(p,a)
126
 
#define ID3DPresent_SetCursor(p,a,b,c) (p)->lpVtbl->SetCursor(p,a,b,c)
127
 
#define ID3DPresent_SetGammaRamp(p,a,b) (p)->lpVtbl->SetGammaRamp(p,a,b)
128
 
#define ID3DPresent_GetWindowInfo(p,a,b,c,d) (p)->lpVtbl->GetWindowInfo(p,a,b,c,d)
129
 
#define ID3DPresent_GetWindowOccluded(p) (p)->lpVtbl->GetWindowOccluded(p)
130
 
#define ID3DPresent_ResolutionMismatch(p) (p)->lpVtbl->ResolutionMismatch(p)
131
 
#define ID3DPresent_CreateThread(p,a,b) (p)->lpVtbl->CreateThread(p,a,b)
132
 
#define ID3DPresent_WaitForThread(p,a) (p)->lpVtbl->WaitForThread(p,a)
133
 
#define ID3DPresent_SetPresentParameters2(p,a) (p)->lpVtbl->SetPresentParameters2(p,a)
134
 
#define ID3DPresent_IsBufferReleased(p,a) (p)->lpVtbl->IsBufferReleased(p,a)
135
 
#define ID3DPresent_WaitBufferReleaseEvent(p) (p)->lpVtbl->WaitBufferReleaseEvent(p)
136
 
 
137
 
typedef struct ID3DPresentGroupVtbl
138
 
{
139
 
    /* IUnknown */
140
 
    HRESULT (WINAPI *QueryInterface)(ID3DPresentGroup *This, REFIID riid, void **ppvObject);
141
 
    ULONG (WINAPI *AddRef)(ID3DPresentGroup *This);
142
 
    ULONG (WINAPI *Release)(ID3DPresentGroup *This);
143
 
 
144
 
    /* ID3DPresentGroup */
145
 
    /* When creating a device, it's relevant for the driver to know how many
146
 
     * implicit swap chains to create. It has to create one per monitor in a
147
 
     * multi-monitor setup */
148
 
    UINT (WINAPI *GetMultiheadCount)(ID3DPresentGroup *This);
149
 
    /* returns only the implicit present interfaces */
150
 
    HRESULT (WINAPI *GetPresent)(ID3DPresentGroup *This, UINT Index, ID3DPresent **ppPresent);
151
 
    /* used to create additional presentation interfaces along the way */
152
 
    HRESULT (WINAPI *CreateAdditionalPresent)(ID3DPresentGroup *This, D3DPRESENT_PARAMETERS *pPresentationParameters, ID3DPresent **ppPresent);
153
 
    void (WINAPI *GetVersion) (ID3DPresentGroup *This, int *major, int *minor);
154
 
} ID3DPresentGroupVtbl;
155
 
 
156
 
struct ID3DPresentGroup
157
 
{
158
 
    ID3DPresentGroupVtbl *lpVtbl;
159
 
};
160
 
 
161
 
/* IUnknown macros */
162
 
#define ID3DPresentGroup_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
163
 
#define ID3DPresentGroup_AddRef(p) (p)->lpVtbl->AddRef(p)
164
 
#define ID3DPresentGroup_Release(p) (p)->lpVtbl->Release(p)
165
 
/* ID3DPresentGroup */
166
 
#define ID3DPresentGroup_GetMultiheadCount(p) (p)->lpVtbl->GetMultiheadCount(p)
167
 
#define ID3DPresentGroup_GetPresent(p,a,b) (p)->lpVtbl->GetPresent(p,a,b)
168
 
#define ID3DPresentGroup_CreateAdditionalPresent(p,a,b) (p)->lpVtbl->CreateAdditionalPresent(p,a,b)
169
 
#define ID3DPresentGroup_GetVersion(p,a,b) (p)->lpVtbl->GetVersion(p,a,b)
170
 
 
171
 
#endif /* __cplusplus */
172
 
 
173
 
#endif /* _D3DADAPTER_PRESENT_H_ */