MFCaptureD3D and DeskBand fixes

MFCaptureD3D: Avoid infinite loop if no matching format is found. #135 fixed by @jameshfisher

DeskBand: Avoid crash due to premature unload. #136

Also update a lot of README files so they show up in the https://docs.microsoft.com/samples browser.

Author: Windows classic samples

Samples/AmsiProvider/README.md

@@ -1,3 +1,17 @@
+---
+page_type: sample
+languages:
+- cpp
+products:
+- windows-api-win32
+name: IAntimalwareProvider interface sample
+urlFragment: iantimalwareprovider-sample
+description: Demonstrates how to use the Antimalware Provider Interface to register as a provider and scan an incoming stream. 
+extendedZipContent:
+- path: LICENSE
+  target: LICENSE
+---
+
 # IAntimalwareProvider interface sample
 
 Demonstrates how to use the Antimalware Provider Interface to register as a provider and scan an incoming stream.
@@ -16,51 +30,25 @@ Note that the provider is loaded as an in-process server, which means that you n
 
 1. Load the Project solution.
 2. Build the Project.
-3. From an elevated command prompt, go to the output directory and type
-````
-regsvr32 AmsiProvider.dll
-````
+3. From an elevated command prompt, go to the output directory and type `regsvr32 AmsiProvider.dll`.
 
-If your system has other providers installed, they may take priority over the sample provider.
-To prevent this from happening (for testing purposes), go to the
-`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AMSI\Providers`
-and
-`HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\AMSI\Providers`
-registry keys and temporarily rename the other providers
-so that the system will use the sample provider.
+If your system has other providers installed, they may take priority over the sample provider. To prevent this from happening (for testing purposes), go to the `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AMSI\Providers` and `HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\AMSI\Providers` registry keys and temporarily rename the other providers so that the system will use the sample provider.
 
 ### Exercising the sample provider
 
-Events logged by the sample provider
-can be captured using ETW tools such as xperf. The log files are generated in
-ETL format so they can be viewed and processed by the Windows Performance
-Toolkit (WPT), as well as utilities such as tracerpt.exe or xperf.exe.
-
-1. From an elevated command prompt, type
-````
-xperf.exe -start mySession -f myFile.etl -on 00604c86-2d25-46d6-b814-cd149bfdf0b3
-````
-to begin capturing events from the provider used by the sample.
+Events logged by the sample provider can be captured using ETW tools such as xperf. The log files are generated in ETL format so they can be viewed and processed by the Windows Performance Toolkit (WPT), as well as utilities such as *tracerpt.exe* or *xperf.exe*.
 
+1. From an elevated command prompt, type `xperf.exe -start mySession -f myFile.etl -on 00604c86-2d25-46d6-b814-cd149bfdf0b3` to begin capturing events from the provider used by the sample.
 2. From an unelevated command prompt, launch PowerShell with the Bypass execution policy.
 The PowerShell program should be the same bitness as the project you built and installed.
-* To run 32-bit PowerShell on a 32-bit system, or 64-bit PowerShell on a 64-bit system: `powershell -ep bypass`
-* To run 32-bit PowerShell on a 64-bit system: `C:\Windows\SysWOW64\WindowsPowerShell\v1.0\powershell -ep bypass`
+   * To run 32-bit PowerShell on a 32-bit system, or 64-bit PowerShell on a 64-bit system: `powershell -ep bypass`
+   * To run 32-bit PowerShell on a 64-bit system: `C:\Windows\SysWOW64\WindowsPowerShell\v1.0\powershell -ep bypass`
 3. Run some PowerShell commands. For example, type `calc` to launch calc.
 4. Exit PowerShell.
-5. From an elevated command prompt, type
-````
-xperf.exe -stop mySession
-````
-to stop capturing events.
-
+5. From an elevated command prompt, type `xperf.exe -stop mySession` to stop capturing events.
 6. View the `myFile.etl` trace graphically in WPA, or generate a text version by typing `tracerpt myFile.etl`.
 
 ### Uninstalling the sample provider
 
-1. From an elevated command prompt, go to the output directory and type
-````
-regsvr32 /u AmsiProvider.dll
-````
-
-If you temporarily renamed conflicting providers when you installed the sample provider, rename the keys back.
+1. From an elevated command prompt, go to the output directory and type `regsvr32 /u AmsiProvider.dll`.
+2. If you temporarily renamed conflicting providers when you installed the sample provider, rename the keys back.

Samples/AmsiStream/README.md

@@ -1,21 +1,32 @@
+---
+page_type: sample
+languages:
+- cpp
+products:
+- windows-api-win32
+name: IAmsiStream interface sample
+urlFragment: iamsistream-sample
+description: Demonstrates how to use the Antimalware Scan Interface to scan a stream. 
+extendedZipContent:
+- path: LICENSE
+  target: LICENSE
+---
+
 # IAmsiStream interface sample
 
 Demonstrates how to use the Antimalware Scan Interface to scan a stream.
 
-The sample implements the
-[IAmsiStream](https://msdn.microsoft.com/en-us/library/windows/desktop/dn889589(v=vs.85).aspx) interface
-so that an antimalware provider can use it to scan the contents of a stream.
+The sample implements the [IAmsiStream](https://msdn.microsoft.com/en-us/library/windows/desktop/dn889589(v=vs.85).aspx) interface so that an antimalware provider can use it to scan the contents of a stream.
 
-The sample demonstrates a stream where the data comes from a file
-and a stream where the data comes from an in-memory buffer.
+The sample demonstrates a stream where the data comes from a file and a stream where the data comes from an in-memory buffer.
 
 ## Instructions
 1. Load the Project solution.
-2. Go to Project Properties, Debugging.
+2. Go to **Project Properties, Debugging**.
 3. To scan an in-memory buffer, leave the *Command Arguments* blank. To scan a file, enter the file's complete path in the *Command Arguments*.
-4. Hit F5 to build and run.
+4. Press **F5** to build and run.
 
-## Sample Output
+## Sample output
 
     Creating stream object with file name: C:\sample.txt
     Calling antimalware->Scan() ...

Samples/AppxPackingCreateAppx/README.md

@@ -1,15 +1,25 @@
-Create app package sample
-=========================
+---
+page_type: sample
+languages:
+- cpp
+products:
+- windows-api-win32
+name: Create app package sample
+urlFragment: create-app-package
+description: Demonstrates how to create an app package by using the app Packaging API.
+---
+
+# Create app package sample
 
 This sample shows you how to create an app package by using the app [Packaging API](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446766).
 
 Users acquire your app as an app package. Windows uses the information in an app package to install the app on a per-user basis, and ensure that all traces of the app are gone from the device after all users who installed the app uninstall it. Each package consists of the files that constitute the app, along with a package manifest file that describes the app to Windows.
 
 The sample covers the following tasks:
 
--   Use [**IAppxFactory::CreatePackageWriter**](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446679) to create a package writer
--   Use [**IAppxPackageWriter::AddPayloadFile**](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446763) to add the payload files to the package
--   Create an input stream and use [**IAppxPackageWriter::Close**](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446764) to write the manifest at the end of the package
+-   Use [IAppxFactory::CreatePackageWriter](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446679) to create a package writer.
+-   Use [IAppxPackageWriter::AddPayloadFile](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446763) to add the payload files to the package.
+-   Create an input stream and use [IAppxPackageWriter::Close](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446764) to write the manifest at the end of the package.
 
 **Warning**  This sample requires Microsoft Visual Studio 2013 or a later version (any SKU); it doesn't compile with Microsoft Visual Studio Express 2013 for Windows.
 
@@ -19,45 +29,17 @@ To get a copy of Windows, go to [Downloads and tools](http://go.microsoft.com/fw
 
 To get a copy of Visual Studio, go to [Visual Studio Downloads](http://go.microsoft.com/fwlink/p/?linkid=301697).
 
-Related topics
---------------
-
-**Sample**
-
-[Extract app package contents sample](http://go.microsoft.com/fwlink/p/?linkid=106455)
-
-**Tasks**
-
-[How to create a package](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446616)
-
-**Concepts**
-
-[App packages and deployment](http://msdn.microsoft.com/en-us/library/windows/desktop/hh464929)
-
-**Reference**
-
-[**IAppxFactory::CreatePackageWriter**](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446679)
-
-[**IAppxPackageWriter**](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446762)
-
-Related technologies
---------------------
-
-[App packaging and deployment](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446593)
+## Operating system requirements
 
-Operating system requirements
------------------------------
-
-Client
+### Client
 
 Windows 8.1
 
-Server
+### Server
 
 Windows Server 2012 R2
 
-Build the sample
-----------------
+## Build the sample
 
 ### From the Command window
 
@@ -67,27 +49,49 @@ Build the sample
 
 3.  Run the following command:
 
-    **msbuild CreateAppx.sln**
+    ```msbuild CreateAppx.sln```
 
 ### From Visual Studio
 
 1.  Start Visual Studio and select **File** \> **Open** \> **Project/Solution**.
 
-2.  Go to the directory where you downloaded the CreateAppx sample and double-click its Microsoft Visual Studio Solution (.sln) file.
+2.  Go to the directory where you downloaded the CreateAppx sample and select its Microsoft Visual Studio Solution (*.sln*) file.
 
-3.  Press F7 (or F6 for Visual Studio 2013) or use **Build** \> **Build Solution**.
+3.  Press **F7** (or **F6** for Visual Studio 2013) or use **Build** \> **Build Solution**.
 
 Run the sample
 --------------
 
 1.  Open a Command window.
 
-2.  Go to the CreateAppx\\Data directory.
+2.  Go to the *CreateAppx\\Data* directory.
 
 3.  Run the following command (where \<path\> is "..\\debug\\CreateAppx" or "..\\release\\CreateAppx"):
 
-    **\<path\>\\CreateAppx**
+    ```\<path\>\\CreateAppx```
+
+    This command creates an app package named *HelloWorld.appx* from the contents of the *CreateAppx\\Data* directory.
+
+## Related topics
+
+### Sample
 
-    This command creates an app package named HelloWorld.appx from the contents of the CreateAppx\\Data directory.
+[Extract app package contents sample](http://go.microsoft.com/fwlink/p/?linkid=106455)
+
+### Tasks
+
+[How to create a package](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446616)
 
+### Concepts
 
+[App packages and deployment](http://msdn.microsoft.com/en-us/library/windows/desktop/hh464929)
+
+### Reference
+
+[IAppxFactory::CreatePackageWriter](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446679)
+
+[IAppxPackageWriter](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446762)
+
+## Related technologies
+
+[App packaging and deployment](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446593)

Samples/AppxPackingCreateBundle/README.md

@@ -1,43 +1,48 @@
-Create app bundle sample
-========================
+---
+page_type: sample
+languages:
+- cpp
+products:
+- windows-api-win32
+name: Create app bundle sample
+urlFragment: create-app-bundle
+description: Demonstrates how to create an app bundle using the Packaging API.
+---
+
+# Create app bundle sample
 
 This sample shows you how to create an app bundle using the [Packaging API](http://msdn.microsoft.com/en-us/library/windows/desktop/hh446766).
 
 The sample covers these tasks:
 
--   Use [**IAppxBundleFactory::CreateBundleWriter**](http://msdn.microsoft.com/en-us/library/windows/desktop/dn280280) to create a bundle writer
--   Use [**IAppxBundleWriter::AddPayloadPackage**](http://msdn.microsoft.com/en-us/library/windows/desktop/dn280303) to add the payload packages to the bundle
--   Create an input stream and use [**IAppxBundleWriter::Close**](http://msdn.microsoft.com/en-us/library/windows/desktop/dn280304) to flush the stream
+-   Use [IAppxBundleFactory::CreateBundleWriter](http://msdn.microsoft.com/en-us/library/windows/desktop/dn280280) to create a bundle writer.
+-   Use [IAppxBundleWriter::AddPayloadPackage](http://msdn.microsoft.com/en-us/library/windows/desktop/dn280303) to add the payload packages to the bundle.
+-   Create an input stream and use [IAppxBundleWriter::Close](http://msdn.microsoft.com/en-us/library/windows/desktop/dn280304) to flush the stream.
 
-Related topics
---------------
+## Operating system requirements
 
-**Reference**
-
-[**IAppxBundleFactory::CreateBundleWriter**](http://msdn.microsoft.com/en-us/library/windows/desktop/dn280280)
-
-[**IAppxBundleWriter**](http://msdn.microsoft.com/en-us/library/windows/desktop/dn280302)
-
-Operating system requirements
------------------------------
-
-Client
+### Client
 
 Windows 8.1
 
-Server
+### Server
 
 Windows Server 2012 R2
 
-Build the sample
-----------------
+## Build the sample
 
 1.  Start Microsoft Visual Studio and select **File** \> **Open** \> **Project/Solution**.
-2.  Go to the directory named for the sample, and double-click the Visual Studio Solution (.sln) file.
-3.  Press F7 or use **Build** \> **Build Solution** to build the sample.
+2.  Go to the directory named for the sample, and double-click the Visual Studio Solution (*.sln*) file.
+3.  Press **F7** or use **Build** \> **Build Solution** to build the sample.
+
+## Run the sample
+
+To debug the app and then run it, press **F5** or use **Debug** \> **Start Debugging**. To run the app without debugging, press **Ctrl**+**F5** or use **Debug** \> **Start Without Debugging**.
+
+## Related topics
 
-Run the sample
---------------
+### Reference
 
-To debug the app and then run it, press F5 or use **Debug** \> **Start Debugging**. To run the app without debugging, press Ctrl+F5 or use **Debug** \> **Start Without Debugging**.
+[IAppxBundleFactory::CreateBundleWriter](http://msdn.microsoft.com/en-us/library/windows/desktop/dn280280)
 
+[IAppxBundleWriter](http://msdn.microsoft.com/en-us/library/windows/desktop/dn280302)