1 /**************************************************************************
2  *
3  * Copyright 2008 VMware, Inc.
4  * All Rights Reserved.
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a
7  * copy of this software and associated documentation files (the
8  * "Software"), to deal in the Software without restriction, including
9  * without limitation the rights to use, copy, modify, merge, publish,
10  * distribute, sub license, and/or sell copies of the Software, and to
11  * permit persons to whom the Software is furnished to do so, subject to
12  * the following conditions:
13  *
14  * The above copyright notice and this permission notice (including the
15  * next paragraph) shall be included in all copies or substantial portions
16  * of the Software.
17  *
18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21  * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
22  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25  *
26  **************************************************************************/
27 
28 /**
29  * @file
30  * Buffer validation.
31  *
32  * @author Jose Fonseca <jfonseca@vmware.com>
33  */
34 
35 #ifndef PB_VALIDATE_H_
36 #define PB_VALIDATE_H_
37 
38 
39 #include "pipe/p_compiler.h"
40 #include "pipe/p_defines.h"
41 
42 #ifdef __cplusplus
43 extern "C" {
44 #endif
45 
46 
47 struct pb_buffer;
48 struct pipe_fence_handle;
49 struct hash_table;
50 
51 
52 /**
53  * Buffer validation list.
54  *
55  * It holds a list of buffers to be validated and fenced when flushing.
56  */
57 struct pb_validate;
58 
59 
60 enum pipe_error
61 pb_validate_add_buffer(struct pb_validate *vl,
62                        struct pb_buffer *buf,
63                        enum pb_usage_flags flags,
64                        struct hash_table *ht,
65                        boolean *already_present);
66 
67 enum pipe_error
68 pb_validate_foreach(struct pb_validate *vl,
69                     enum pipe_error (*callback)(struct pb_buffer *buf, void *data),
70                     void *data);
71 
72 /**
73  * Validate all buffers for hardware access.
74  *
75  * Should be called right before issuing commands to the hardware.
76  */
77 enum pipe_error
78 pb_validate_validate(struct pb_validate *vl);
79 
80 /**
81  * Fence all buffers and clear the list.
82  *
83  * Should be called right after issuing commands to the hardware.
84  */
85 void
86 pb_validate_fence(struct pb_validate *vl,
87                   struct pipe_fence_handle *fence);
88 
89 struct pb_validate *
90 pb_validate_create(void);
91 
92 void
93 pb_validate_destroy(struct pb_validate *vl);
94 
95 
96 #ifdef __cplusplus
97 }
98 #endif
99 
100 #endif /*PB_VALIDATE_H_*/
101