###### (This is the legacy documentation for SDL2, the previous stable version; [SDL3](https://wiki.libsdl.org/SDL3/) is the current stable version.)
# SDL_Vulkan_GetInstanceExtensions

Get the names of the Vulkan instance extensions needed to create a surface with [SDL_Vulkan_CreateSurface](SDL_Vulkan_CreateSurface).

## Header File

Defined in [SDL_vulkan.h](https://github.com/libsdl-org/SDL/blob/SDL2/include/SDL_vulkan.h)

## Syntax

```c
SDL_bool SDL_Vulkan_GetInstanceExtensions(SDL_Window *window,
                                          unsigned int *pCount,
                                          const char **pNames);
```

## Function Parameters

|                            |            |                                                                                                                          |
| -------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| [SDL_Window](SDL_Window) * | **window** | A window for which the required Vulkan instance extensions should be retrieved (will be deprecated in a future release). |
| unsigned int *             | **pCount** | A pointer to an unsigned int corresponding to the number of extensions to be returned.                                   |
| const char **              | **pNames** | NULL or a pointer to an array to be filled with required Vulkan instance extensions.                                     |

## Return Value

([SDL_bool](SDL_bool)) Returns [SDL_TRUE](SDL_TRUE) on success,
[SDL_FALSE](SDL_FALSE) on error.

## Remarks

If `pNames` is NULL, then the number of required Vulkan instance extensions
is returned in `pCount`. Otherwise, `pCount` must point to a variable set
to the number of elements in the `pNames` array, and on return the variable
is overwritten with the number of names actually written to `pNames`. If
`pCount` is less than the number of required extensions, at most `pCount`
structures will be written. If `pCount` is smaller than the number of
required extensions, [SDL_FALSE](SDL_FALSE) will be returned instead of
[SDL_TRUE](SDL_TRUE), to indicate that not all the required extensions were
returned.

The `window` parameter is currently needed to be valid as of SDL 2.0.8,
however, this parameter will likely be removed in future releases

## Version

This function is available since SDL 2.0.6.

## See Also

- [SDL_Vulkan_CreateSurface](SDL_Vulkan_CreateSurface)

----
[CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction), [CategoryVulkan](CategoryVulkan)