Remote Control Windows 10 1709 (Falls Creator Update) Patch Deployment

Document ID : KB000072391
Last Modified Date : 16/07/2018
Show Technical Document Details
Issue:
Since the release of Microsoft Windows 10 version 1709 (Falls Creator Update), the mirror driver for Remote Control has stopped working.
Environment:
Client Automation -- r14 SP2.
Cause:
The Remote Control feature relies on the Microsoft Windows’ API (EnumDisplayDevices) that lists all the display drivers installed on a machine. This API was working fine on previous versions of the operating system, including Windows 10 version 1703. But with Windows 10 version 1709, this API is no longer working as expected. As a result, the RC Device Driver is unable to capture the target machine’s display, leading to an unwanted user message appearing and poor RC session performance.
Resolution:
Development has published the following patches for r14 SP2, to address the problem:
SO00966: WIN-WIN 10 1709 RC VIDEO CAPTURE ADAPTER 64BIT
SO00968: WIN-WIN 10 1709 RC VIDEO CAPTURE ADAPTER 32 BIT

Note these patches were initially released as the following test fixes and are exactly equivalent:
T5SM158 (Win10 1709 RCVideo capture x64)
T5SM159 (Win10 1709 RCVideo capture 32bit)

Attached to this KB article are various scripts written by CA Support to help get these fixes deployed in your environment.  Refer to the "RC Deployment Methods.zip" attachment when reviewing these deployment options.  The attachment can be found at the bottom of this article.

Method 1: Batch Script
Reference: RC Driver Update Package.zip

- Extract the ZIP on the target system and run MirrorInst.cmd.
--> The script will verify ITCM is installed, the RC feature is installed and the system architecture (x86 vs x64).
--> Once verified it will copy the appropriate RCMirrorInstall.exe and execute RCMirrorInstall.exe -install.

Sample output:
User-added image

Method 2: Software Package based on Batch Script
Reference: RC Driver Update Package.zip

- It's the same script from Method #1 above, except it's pre-packaged for Software Delivery.
- Copy/Paste the folder containing the regino folder and the fix files, into DSM Explorer --> Software --> Software Package Library.
- Once imported, you can use this package to push to agents.
- The procedure is setup to use the $rf macro, so job output will be returned back to Software Delivery.

User-added image

Method 3: WinOffline (Interactively)
Reference: T5SM158 (Win10 1709 RCVideo capture).zip

- Simply double-click WinOffline.exe or execute WinOffline.exe via command line.

- The JCL file is configured only to run MirrorInst.cmd, the same batch file from methods #1 and #2:
SYSCMD:MirrorInst.cmd

- WinOffline will stop CAF, run MirrorInst.cmd, and start CAF.

- Optionally add the -signalreboot or -reboot switches if you want to trigger a reboot.  The -signalreboot switch invokes sd_acmd signal reboot, and will perform a reboot based on config policy settings (e.g. polite or not polite with some options to extend/defer).  The -reboot switch will force a reboot of Windows.

Note: For those die-hard ApplyPTF fans, ApplyPTF has a limitation where it requires at least one "FILE:" replacement tag in a JCL file.  WinOffline does not have this limitation, and can "apply" a patch based on a JCL that contains only a "SYSCMD:" tag.

- The output from the MirrorInst.cmd file will be captured in the WinOffline status console and debug log.  The debug log is always saved to the root of the DSM folder if you need to review it.

- Running WinOffline interactively or via command line, you will see the result:

Interactively:

User-added image

User-added image

 

Command Line:

User-added image

User-added image

Method 4: WinOffline (Software Delivery)
Reference: WinOffline-T5SM158 (Win10 1709 RCVideo capture).zip

- It's the same ZIP file from Method #3, and you will notice it contains a "reginfo" folder.
- This means it can be registered as a software package in Software Delivery.
- Once it's registered as a package, you can push to target agents.

User-added image

When the job's done, you will be able to see the output:

User-added image

And if you scroll further down the job output, you can see the execution of the MirrorInst.cmd file:

User-added image

Note: All the attachments use the latest version of WinOffline, 2018.02.20, which will replace the 2018.01.03 version posted previously to the community.

File Attachments:
RC Fix Deployment Methods.zip