SDL_GetDisplays - Man Page

Get a list of currently connected displays.

Header File

Defined in SDL3/SDL_video.h

Synopsis

#include "SDL3/SDL.h"

SDL_DisplayID * SDL_GetDisplays(int *count);

Function Parameters

count

a pointer filled in with the number of displays returned, may be NULL.

Return Value

( SDL_DisplayID
*) Returns a 0 terminated array of display instance IDs or NULL on failure; call SDL_GetError () for more information. This should be freed with SDL_free () when it is no longer needed.

Thread Safety

This function should only be called on the main thread.

Availability

This function is available since SDL 3.2.0.

Referenced By

SDL_GetClosestFullscreenDisplayMode(3), SDL_GetCurrentDisplayMode(3), SDL_GetCurrentDisplayOrientation(3), SDL_GetDesktopDisplayMode(3), SDL_GetDisplayBounds(3), SDL_GetDisplayContentScale(3), SDL_GetDisplayForPoint(3), SDL_GetDisplayForRect(3), SDL_GetDisplayForWindow(3), SDL_GetDisplayName(3), SDL_GetDisplayUsableBounds(3), SDL_GetFullscreenDisplayModes(3), SDL_GetNaturalDisplayOrientation(3), SDL_GetPrimaryDisplay(3).

SDL 3.2.2 Simple Directmedia Layer SDL3 FUNCTIONS