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