Structures

VkSurfaceFullScreenExclusiveWin32InfoEXT

Structure specifying additional creation parameters specific to Win32 fullscreen exclusive mode

The VkSurfaceFullScreenExclusiveWin32InfoEXT structure is defined as:

typedef struct VkSurfaceFullScreenExclusiveWin32InfoEXT {
    VkStructureType sType;
    const void* pNext;
    HMONITOR hmonitor;
} VkSurfaceFullScreenExclusiveWin32InfoEXT;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • hmonitor is the Win32 HMONITOR handle identifying the display to create the surface with.

If hmonitor is invalidated (e.g. the monitor is unplugged) during the lifetime of a swapchain created with this structure, operations on that swapchain will return VK_ERROR_OUT_OF_DATE_KHR.

It is the responsibility of the application to change the display settings of the targeted Win32 display using the appropriate platform APIs. Such changes may alter the surface capabilities reported for the created surface.

Valid Usage

Valid Usage (Implicit)

VUID-VkSurfaceFullScreenExclusiveWin32InfoEXT-sType-sType

sType must be VK_STRUCTURE_TYPE_SURFACE_FULL_SCREEN_EXCLUSIVE_WIN32_INFO_EXT