fdo-mirrors/mesa
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/mesa/mesa.git synced 2025-12-30 16:30:10 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

vulkan,docs: Document vk_physical_device

Browse source 
Acked-by: Iago Toral Quiroga <itoral@igalia.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/15472>
This commit is contained in:
Jason Ekstrand 2022-03-21 18:18:04 -05:00 • committed by Marge Bot
parent f6d4641433
commit 6073610d7a
2 changed files with 39 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
docs/vulkan/base-objs.rst
View file

@ -164,3 +164,12 @@ We also provide an implementation of
}
.. doxygenfunction:: vk_enumerate_instance_extension_properties
vk_physical_device
------------------
.. doxygenstruct:: vk_physical_device
:members:
.. doxygenfunction:: vk_physical_device_init
.. doxygenfunction:: vk_physical_device_finish

31
src/vulkan/runtime/vk_physical_device.h
View file

@ -34,14 +34,30 @@ extern "C" {
struct wsi_device;
struct vk_sync_type;
/** Base struct for all VkPhysicalDevice implementations
*/
struct vk_physical_device {
struct vk_object_base base;
/** Instance which is the parent of this physical device */
struct vk_instance *instance;
/** Table of all supported device extensions
*
* This table is initialized from the `supported_extensions` parameter
* passed to `vk_physical_device_init()` if not `NULL`. If a `NULL`
* extension table is passed, all extensions are initialized to false and
* it's the responsibility of the driver to populate the table. This may
* be useful if the driver's physical device initialization order is such
* that extension support cannot be determined until significant physical
* device setup work has already been done.
*/
struct vk_device_extension_table supported_extensions;
/** Physical-device-level dispatch table */
struct vk_physical_device_dispatch_table dispatch_table;
/** WSI device, or NULL */
struct wsi_device *wsi_device;
/** A null-terminated array of supported sync types, in priority order
@ -57,14 +73,27 @@ struct vk_physical_device {
};
VK_DEFINE_HANDLE_CASTS(vk_physical_device, base, VkPhysicalDevice,
VK_OBJECT_TYPE_PHYSICAL_DEVICE)
VK_OBJECT_TYPE_PHYSICAL_DEVICE);
/** Initialize a vk_physical_device
*
* @param[out] physical_device The physical device to initialize
* @param[in] instance The instance which is the parent of this
* physical device
* @param[in] supported_extensions Table of all device extensions supported
* by this physical device
* @param[in] dispatch_table Physical-device-level dispatch table
*/
VkResult MUST_CHECK
vk_physical_device_init(struct vk_physical_device *physical_device,
struct vk_instance *instance,
const struct vk_device_extension_table *supported_extensions,
const struct vk_physical_device_dispatch_table *dispatch_table);
/** Tears down a vk_physical_device
*
* @param[out] physical_device The physical device to tear down
*/
void
vk_physical_device_finish(struct vk_physical_device *physical_device);