summaryrefslogtreecommitdiff
path: root/general/echo/umdf2
diff options
context:
space:
mode:
authorBarry Golden <[email protected]>2019-03-12 14:02:43 -0700
committerAdonais Romero González <[email protected]>2019-03-12 14:02:43 -0700
commitef7ec4ec9ff7ce3c53d60e1c8906915966e17e01 (patch)
tree3017523a73c6552c27947d402afa6062f4df2706 /general/echo/umdf2
parent35bff356ac249057f4d673d39c7f28ed348cbf0f (diff)
Update README.md for samples portal (#358)
* Update README.md for samples portal * Update README.md for samples portal * Removed installwdf * Update fork (#2) * Fix typo ture -> true * Remove InstallWdf sample * Fix typo (#340) ture -> true * Readme typo fix (#349) * Update langid
Diffstat (limited to 'general/echo/umdf2')
-rw-r--r--general/echo/umdf2/README.md31
-rw-r--r--general/echo/umdf2/general-echo-umdf2.yml12
2 files changed, 19 insertions, 24 deletions
diff --git a/general/echo/umdf2/README.md b/general/echo/umdf2/README.md
index a9ec9e76..30bbd454 100644
--- a/general/echo/umdf2/README.md
+++ b/general/echo/umdf2/README.md
@@ -1,3 +1,13 @@
+---
+topic: sample
+name: Echo Sample (UMDF Version 2)
+description: Demonstrates how to use UMDF 2 to write a driver and to employ best practices.
+languages:
+ - cpp
+products:
+ - windows
+---
+
<!---
name: Echo Sample (UMDF Version 2)
platform: UMDF2
@@ -7,14 +17,14 @@
samplefwlink: http://go.microsoft.com/fwlink/p/?LinkId=617708
--->
-Echo Sample (UMDF Version 2)
-============================
+# Echo Sample (UMDF Version 2)
The ECHO (UMDF version 2) sample demonstrates how to use a sequential queue to serialize read and write requests presented to the driver.
It also shows how to synchronize execution of these events with other asynchronous events such as request cancellation and DPC.
## Universal Windows Driver Compliant
+
This sample builds a Universal Windows Driver. It uses only APIs and DDIs that are included in OneCoreUAP.
Related technologies
@@ -22,7 +32,6 @@ Related technologies
[User-Mode Driver Framework](http://msdn.microsoft.com/en-us/library/windows/hardware/ff560456)
-
Open the driver solution in Visual Studio
-----------------------------------------
@@ -31,13 +40,12 @@ In Microsoft Visual Studio, open the solution file (umdf2echo.sln). Choose **Sol
Set the configuration and platform in Visual Studio
---------------------------------------------------
-In Visual Studio, in Solution Explorer, right click **Solution**, and choose **Configuration Manager**. Set the configuration and the platform. Make sure that the configuration and platform are the same for both the driver project and the package project. Do not check the **Deploy** boxes.
-
+In Visual Studio, in Solution Explorer, right click **Solution**, and choose **Configuration Manager**. Set the configuration and the platform. Make sure that the configuration and platform are the same for both the driver project and the package project. Do not check the **Deploy** boxes.
Locate the built driver package
-------------------------------
-In File Explorer, navigate to the folder that contains your built driver package. The location of this folder varies depending on what you set for configuration and platform.
+In File Explorer, navigate to the folder that contains your built driver package. The location of this folder varies depending on what you set for configuration and platform.
Run the sample
--------------
@@ -50,16 +58,16 @@ The process of moving the driver package to the target computer and installing t
Before you automatically deploy a driver, you must provision the target computer. For instructions, see [Configuring a Computer for Driver Deployment, Testing, and Debugging](http://msdn.microsoft.com/en-us/library/windows/hardware/).
-1. On the host computer, in Visual Studio, in Solution Explorer, right click **package** (lower case), and choose **Properties**. Navigate to **Configuration Properties \> Driver Install \> Deployment**.
-2. Check **Enable deployment**, and check **Remove previous driver versions before deployment**. For **Target Computer Name**, select the name of a target computer that you provisioned previously. Select **Hardware ID Driver Update**, and enter **root\\ECHO** for the hardware ID. Click **OK**.
-3. On the **Build** menu, choose **Build Solution**.
+1. On the host computer, in Visual Studio, in Solution Explorer, right click **package** (lower case), and choose **Properties**. Navigate to **Configuration Properties \> Driver Install \> Deployment**.
+1. Check **Enable deployment**, and check **Remove previous driver versions before deployment**. For **Target Computer Name**, select the name of a target computer that you provisioned previously. Select **Hardware ID Driver Update**, and enter **root\\ECHO** for the hardware ID. Click **OK**.
+1. On the **Build** menu, choose **Build Solution**.
### Manual deployment (root enumerated)
Before you manually deploy a driver, you must turn on test signing and install a certificate on the target computer. You also need to copy the [DevCon](http://msdn.microsoft.com/en-us/library/windows/hardware/ff544707) tool to the target computer. For instructions, see [Preparing a Computer for Manual Driver Deployment](http://msdn.microsoft.com/en-us/library/windows/hardware/dn265571).
-1. Copy all of the files in your driver package to a folder on the target computer (for example, c:\\umdf2echoPkg).
-2. On the target computer, open a Command Prompt window as Administrator. Navigate to your driver package folder, and enter the following command:
+1. Copy all of the files in your driver package to a folder on the target computer (for example, c:\\umdf2echoPkg).
+1. On the target computer, open a Command Prompt window as Administrator. Navigate to your driver package folder, and enter the following command:
**devcon install echoum.inf root\\ECHO**
@@ -77,4 +85,3 @@ As an alternative to building the driver sample in Visual Studio, you can build
**msbuild /p:configuration="Release" /p:platform="Win32" umdf2echo.sln**
For more information about using MSBuild to build a driver package, see [Building a Driver](http://msdn.microsoft.com/en-us/library/windows/hardware/ff554644).
-
diff --git a/general/echo/umdf2/general-echo-umdf2.yml b/general/echo/umdf2/general-echo-umdf2.yml
deleted file mode 100644
index 62d719f3..00000000
--- a/general/echo/umdf2/general-echo-umdf2.yml
+++ /dev/null
@@ -1,12 +0,0 @@
-### YamlMime:Sample
-sample:
-- name: Echo Sample (UMDF Version 2)
- description: Demonstrates how to use UMDF 2 to write a driver and to employ best practices.
- generateZip: true
- preserveParentHierarchy: true
- author: windows-driver-samples
- languages:
- - cpp
- technologies:
- - windows
- vssolution: /general/echo/umdf2/umdf2echo.sln