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 50 51 /** 52 * Buffer validation list. 53 * 54 * It holds a list of buffers to be validated and fenced when flushing. 55 */ 56 struct pb_validate; 57 58 59 enum pipe_error 60 pb_validate_add_buffer(struct pb_validate *vl, 61 struct pb_buffer *buf, 62 unsigned flags); 63 64 enum pipe_error 65 pb_validate_foreach(struct pb_validate *vl, 66 enum pipe_error (*callback)(struct pb_buffer *buf, void *data), 67 void *data); 68 69 /** 70 * Validate all buffers for hardware access. 71 * 72 * Should be called right before issuing commands to the hardware. 73 */ 74 enum pipe_error 75 pb_validate_validate(struct pb_validate *vl); 76 77 /** 78 * Fence all buffers and clear the list. 79 * 80 * Should be called right after issuing commands to the hardware. 81 */ 82 void 83 pb_validate_fence(struct pb_validate *vl, 84 struct pipe_fence_handle *fence); 85 86 struct pb_validate * 87 pb_validate_create(void); 88 89 void 90 pb_validate_destroy(struct pb_validate *vl); 91 92 93 #ifdef __cplusplus 94 } 95 #endif 96 97 #endif /*PB_VALIDATE_H_*/ 98