Enable Monitor Switching During Active KVM Session in Cloud Deployment

[graikhel-intel]

As an ISV,
I want the ability to switch between multiple monitors connected to a device during an active KVM session,
So that I can view and interact with the correct display when managing multi-monitor systems remotely.

Technical Notes:

• Use IPS_ScreenSettingData.GET to detect how many screens are connected. Reference: IPS_ScreenSettingData
  
• Use IPS_KVMRedirectionSettingData.PUT to update the DefaultScreen property and switch the active screen. Reference: IPS_KVMRedirectionSettingData

Open/Spike:

• I do not know if the mouse gets misaligned if we change the screen, need to figure that out.
• If the default screen is changed and then user reconnects to KVM again, will see the default screen?

Acceptance Criteria

• New API: Detect Connected Monitors
    - Implement a new API in MPS that uses IPS_ScreenSettingData.GET (see property IsActive) to detect and return the number of connected monitors.
• New API: Change Default Screen
    - Implement a new API in MPS that sends IPS_KVMRedirectionSettingData.PUT with the updated DefaultScreen value to switch the active screen during a KVM session.
• UI Changes
  • Display available screens in the KVM UI (e.g., dropdown or buttons).
  • Allow the user to switch the active screen during an ongoing KVM session using the new API.
  • Ensure the screen switch is reflected in the KVM viewer without restarting the session.
• Validation
• Unit Tests

[graikhel-intel]

Capturing the xml messages for ---> GET IPS_ScreenSettingData, GET IPS_KVMRedirectionSettingData and PUT IPS_KVMRedirectionSettingData

<?xml version="1.0" encoding="utf-8"?>
<Envelope
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns:a="http://schemas.xmlsoap.org/ws/2004/08/addressing"
	xmlns:w="http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd"
	xmlns="http://www.w3.org/2003/05/soap-envelope" >
	<Header>
		<a:Action>http://schemas.xmlsoap.org/ws/2004/09/transfer/Get</a:Action>
		<a:To>/wsman</a:To>
		<w:ResourceURI>http://intel.com/wbem/wscim/1/ips-schema/1/IPS_ScreenSettingData</w:ResourceURI>
		<a:MessageID>194</a:MessageID>
		<a:ReplyTo>
			<a:Address>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</a:Address>
		</a:ReplyTo>
		<w:OperationTimeout>PT60S</w:OperationTimeout>
	</Header>
	<Body/>
</Envelope>

<?xml version="1.0" encoding="UTF-8"?>
<a:Envelope
	xmlns:a="http://www.w3.org/2003/05/soap-envelope"
	xmlns:b="http://schemas.xmlsoap.org/ws/2004/08/addressing"
	xmlns:c="http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd"
	xmlns:d="http://schemas.xmlsoap.org/ws/2005/02/trust"
	xmlns:e="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
	xmlns:f="http://schemas.dmtf.org/wbem/wsman/1/cimbinding.xsd"
	xmlns:g="http://intel.com/wbem/wscim/1/ips-schema/1/IPS_ScreenSettingData"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<a:Header>
		<b:To>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</b:To>
		<b:RelatesTo>194</b:RelatesTo>
		<b:Action a:mustUnderstand="true">http://schemas.xmlsoap.org/ws/2004/09/transfer/GetResponse</b:Action>
		<b:MessageID>uuid:00000000-8086-8086-8086-000000000310</b:MessageID>
		<c:ResourceURI>http://intel.com/wbem/wscim/1/ips-schema/1/IPS_ScreenSettingData</c:ResourceURI>
	</a:Header>
	<a:Body>
		<g:IPS_ScreenSettingData>
			<g:ElementName></g:ElementName>
			<g:InstanceID>Intel(r) Screen Settings</g:InstanceID>
			<g:IsActive>true</g:IsActive>
			<g:IsActive>true</g:IsActive>
			<g:IsActive>false</g:IsActive>
			<g:IsActive>false</g:IsActive>
			<g:PrimaryIndex>1</g:PrimaryIndex>
			<g:QuadraryIndex>0</g:QuadraryIndex>
			<g:ResolutionX>1920</g:ResolutionX>
			<g:ResolutionX>1920</g:ResolutionX>
			<g:ResolutionX>0</g:ResolutionX>
			<g:ResolutionX>0</g:ResolutionX>
			<g:ResolutionY>1080</g:ResolutionY>
			<g:ResolutionY>1080</g:ResolutionY>
			<g:ResolutionY>0</g:ResolutionY>
			<g:ResolutionY>0</g:ResolutionY>
			<g:SecondaryIndex>2</g:SecondaryIndex>
			<g:TertiaryIndex>0</g:TertiaryIndex>
			<g:UpperLeftX>0</g:UpperLeftX>
			<g:UpperLeftX>1920</g:UpperLeftX>
			<g:UpperLeftX>0</g:UpperLeftX>
			<g:UpperLeftX>0</g:UpperLeftX>
			<g:UpperLeftY>0</g:UpperLeftY>
			<g:UpperLeftY>0</g:UpperLeftY>
			<g:UpperLeftY>0</g:UpperLeftY>
			<g:UpperLeftY>0</g:UpperLeftY>
		</g:IPS_ScreenSettingData>
	</a:Body>
</a:Envelope>


<?xml version="1.0" encoding="utf-8"?>
<Envelope
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns:a="http://schemas.xmlsoap.org/ws/2004/08/addressing"
	xmlns:w="http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd"
	xmlns="http://www.w3.org/2003/05/soap-envelope" >
	<Header>
		<a:Action>http://schemas.xmlsoap.org/ws/2004/09/transfer/Get</a:Action>
		<a:To>/wsman</a:To>
		<w:ResourceURI>http://intel.com/wbem/wscim/1/ips-schema/1/IPS_KVMRedirectionSettingData</w:ResourceURI>
		<a:MessageID>195</a:MessageID>
		<a:ReplyTo>
			<a:Address>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</a:Address>
		</a:ReplyTo>
		<w:OperationTimeout>PT60S</w:OperationTimeout>
	</Header>
	<Body />
</Envelope>


<?xml version="1.0" encoding="UTF-8"?>
<a:Envelope
	xmlns:a="http://www.w3.org/2003/05/soap-envelope"
	xmlns:b="http://schemas.xmlsoap.org/ws/2004/08/addressing"
	xmlns:c="http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd"
	xmlns:d="http://schemas.xmlsoap.org/ws/2005/02/trust"
	xmlns:e="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
	xmlns:f="http://schemas.dmtf.org/wbem/wsman/1/cimbinding.xsd"
	xmlns:g="http://intel.com/wbem/wscim/1/ips-schema/1/IPS_KVMRedirectionSettingData"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<a:Header>
		<b:To>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</b:To>
		<b:RelatesTo>195</b:RelatesTo>
		<b:Action a:mustUnderstand="true">http://schemas.xmlsoap.org/ws/2004/09/transfer/GetResponse</b:Action>
		<b:MessageID>uuid:00000000-8086-8086-8086-000000000311</b:MessageID>
		<c:ResourceURI>http://intel.com/wbem/wscim/1/ips-schema/1/IPS_KVMRedirectionSettingData</c:ResourceURI>
	</a:Header>
	<a:Body>
		<g:IPS_KVMRedirectionSettingData>
			<g:BackToBackFbMode>false</g:BackToBackFbMode>
			<g:DefaultScreen>0</g:DefaultScreen>
			<g:DoubleBufferActive>false</g:DoubleBufferActive>
			<g:DoubleBufferEnabled>true</g:DoubleBufferEnabled>
			<g:ElementName>Intel(r) KVM Redirection Settings</g:ElementName>
			<g:EnabledByMEBx>true</g:EnabledByMEBx>
			<g:GrayscalePixelFormatSupported>true</g:GrayscalePixelFormatSupported>
			<g:InitialDecimationModeForLowRes>2</g:InitialDecimationModeForLowRes>
			<g:InstanceID>Intel(r) KVM Redirection Settings</g:InstanceID>
			<g:Is5900PortEnabled>false</g:Is5900PortEnabled>
			<g:OptInPolicy>false</g:OptInPolicy>
			<g:RFBPassword></g:RFBPassword>
			<g:SessionTimeout>3</g:SessionTimeout>
			<g:ZlibControlSupported>true</g:ZlibControlSupported>
		</g:IPS_KVMRedirectionSettingData>
	</a:Body>
</a:Envelope>


<?xml version="1.0" encoding="utf-8"?>
<Envelope
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns:a="http://schemas.xmlsoap.org/ws/2004/08/addressing"
	xmlns:w="http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd"
	xmlns="http://www.w3.org/2003/05/soap-envelope" >
	<Header>
		<a:Action>http://schemas.xmlsoap.org/ws/2004/09/transfer/Put</a:Action>
		<a:To>/wsman</a:To>
		<w:ResourceURI>http://intel.com/wbem/wscim/1/ips-schema/1/IPS_KVMRedirectionSettingData</w:ResourceURI>
		<a:MessageID>196</a:MessageID>
		<a:ReplyTo>
			<a:Address>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</a:Address>
		</a:ReplyTo>
		<w:OperationTimeout>PT60.000S</w:OperationTimeout>
	</Header>
	<Body>
		<r:IPS_KVMRedirectionSettingData
			xmlns:r="http://intel.com/wbem/wscim/1/ips-schema/1/IPS_KVMRedirectionSettingData">
			<r:BackToBackFbMode>false</r:BackToBackFbMode>
			<r:DefaultScreen>1</r:DefaultScreen>
			<r:DoubleBufferActive>false</r:DoubleBufferActive>
			<r:DoubleBufferEnabled>true</r:DoubleBufferEnabled>
			<r:ElementName>Intel(r) KVM Redirection Settings</r:ElementName>
			<r:EnabledByMEBx>true</r:EnabledByMEBx>
			<r:GrayscalePixelFormatSupported>true</r:GrayscalePixelFormatSupported>
			<r:InitialDecimationModeForLowRes>2</r:InitialDecimationModeForLowRes>
			<r:InstanceID>Intel(r) KVM Redirection Settings</r:InstanceID>
			<r:Is5900PortEnabled>false</r:Is5900PortEnabled>
			<r:OptInPolicy>false</r:OptInPolicy>
			<r:RFBPassword></r:RFBPassword>
			<r:SessionTimeout>3</r:SessionTimeout>
			<r:ZlibControlSupported>true</r:ZlibControlSupported>
		</r:IPS_KVMRedirectionSettingData>
	</Body>
</Envelope>

<?xml version="1.0" encoding="UTF-8"?>
<a:Envelope
	xmlns:a="http://www.w3.org/2003/05/soap-envelope"
	xmlns:b="http://schemas.xmlsoap.org/ws/2004/08/addressing"
	xmlns:c="http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd"
	xmlns:d="http://schemas.xmlsoap.org/ws/2005/02/trust"
	xmlns:e="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
	xmlns:f="http://schemas.dmtf.org/wbem/wsman/1/cimbinding.xsd"
	xmlns:g="http://intel.com/wbem/wscim/1/ips-schema/1/IPS_KVMRedirectionSettingData"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<a:Header>
		<b:To>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</b:To>
		<b:RelatesTo>196</b:RelatesTo>
		<b:Action a:mustUnderstand="true">http://schemas.xmlsoap.org/ws/2004/09/transfer/PutResponse</b:Action>
		<b:MessageID>uuid:00000000-8086-8086-8086-000000000347</b:MessageID>
		<c:ResourceURI>http://intel.com/wbem/wscim/1/ips-schema/1/IPS_KVMRedirectionSettingData</c:ResourceURI>
	</a:Header>
	<a:Body>
		<g:IPS_KVMRedirectionSettingData>
			<g:BackToBackFbMode>false</g:BackToBackFbMode>
			<g:DefaultScreen>1</g:DefaultScreen>
			<g:DoubleBufferActive>true</g:DoubleBufferActive>
			<g:DoubleBufferEnabled>true</g:DoubleBufferEnabled>
			<g:ElementName>Intel(r) KVM Redirection Settings</g:ElementName>
			<g:EnabledByMEBx>true</g:EnabledByMEBx>
			<g:GrayscalePixelFormatSupported>true</g:GrayscalePixelFormatSupported>
			<g:InitialDecimationModeForLowRes>2</g:InitialDecimationModeForLowRes>
			<g:InstanceID>Intel(r) KVM Redirection Settings</g:InstanceID>
			<g:Is5900PortEnabled>false</g:Is5900PortEnabled>
			<g:OptInPolicy>false</g:OptInPolicy>
			<g:RFBPassword></g:RFBPassword>
			<g:SessionTimeout>3</g:SessionTimeout>
			<g:ZlibControlSupported>true</g:ZlibControlSupported>
		</g:IPS_KVMRedirectionSettingData>
	</a:Body>
</a:Envelope>