summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStephen Griffin <[email protected]>2018-02-12 13:49:05 -0500
committerGitHub <[email protected]>2018-02-12 13:49:05 -0500
commitc97def4e22793a07317c1c0170fd000f995765dd (patch)
tree2dc5dbc394231d8e41b38b49da38435450472ed4
parent5db40a4daf10bdb19620d3d64215a60f2cd5378a (diff)
Update README.md
Update build instructions. Resolves #123. Resolves #197. Resolves #206. Resolves #31.
-rw-r--r--print/XPSDrvSmpl/README.md36
1 files changed, 20 insertions, 16 deletions
diff --git a/print/XPSDrvSmpl/README.md b/print/XPSDrvSmpl/README.md
index 7c75a314..79618500 100644
--- a/print/XPSDrvSmpl/README.md
+++ b/print/XPSDrvSmpl/README.md
@@ -23,26 +23,30 @@ The sample broadly consists of three components: a set of filters, a configurati
Build the sample
----------------
-To build a driver solution using Windows Driver Kit (WDK) 10 and Visual Studio 2015, perform the following steps.
+To build a driver solution using Windows Driver Kit (WDK) 10 and Visual Studio 2017, perform the following steps.
-1. Open the solution file in Visual Studio 2015.
+1. Open the solution file in Visual Studio 2017.
2. Add all non-binary files (usually located in the \\install directory of the sample) to the Package project:
- a. In the **Solution Explorer**, right click **Driver Files**
- b. Select **Add**, then click **Existing Item**
- c. Navigate to the location to which you downloaded the sample, and select all the files in the install directory, or the equivalent set of non-binary files such as INFs, INIs, GPD, PPD files, etc.
- d. Click **Add**
+ 1. In the **Solution Explorer**, expand the **package** project and right click **Driver Files**
+ 2. Select **Add**, then click **Existing Item**
+ 3. Navigate to the location to which you downloaded the sample, and select all the files in the **install** directory, or the equivalent set of non-binary files such as INFs, INIs, GPD, PPD files, etc.
+ 4. Click **Add**
3. Configure these files to be added into the driver package:
- a. In the **Solution Explorer**, right click on the solution and choose **Add** > **New Project**. Choose **Driver Install Package** under Visual C++/Windows Driver/Package.
- b. In the **Solution Explorer**, right click the Package project and select **Properties**.
- c. In the left pane, click **Configuration Properties** \> **Driver Install** \> **Package Files**.
- d. In the right pane, use the ellipsis button (...) to browse to the set of files that needs to be added to the driver package. All the data files that you added in **Step 2-c**, except the INF file, should be added. This configuration is per-architecture, so this configuration must be repeated for each architecture that will be built.
- e. Click **OK**.
-4. Open the INF file and edit it to match the built output.
- a. Open the INF file.
- b. In the Version section, add a reference to a catalog file like this: CatalogFile=XpsDrvSmpl.cat.
- c. In the SourceDisksFiles section, change the location of the DLL files you are building, to =1. This indicates that there is no architecture specific directory in this driver. If you ship multiple architectures simultaneously, you will need to collate the driver INF manually.
+ 1. In the **Solution Explorer**, right click on the solution and choose **Add** > **New Project**. Choose **Driver Install Package** under Visual C++/Windows Driver/Package.
+ 2. In the **Solution Explorer**, right click the **Driver Package** project and select **Properties**.
+ 3. In the left pane, click **Configuration Properties** \> **Driver Install** \> **Package Files**. (If **Package Files** is not available, you may need to re-install the **Windows Driver Kit**.)
+ 4. In the right pane, click **<Edit...>** and use the ellipsis button (...) to browse to the set of files that needs to be added to the driver package. All of the data files added in **Step 2.iii**, except the INF file, should be added. This configuration is per architecture, so this configuration must be repeated for each architecture that will be built.
+ 5. Click **OK**.
+4. Add a reference to the driver package.
+ 1. In the **Solution Explorer**, right click the **package** project and select **Add Reference**.
+ 2. In the right pane, check the **Driver Package** created in step 3.
+ 3. Click **OK**.
+5. Open the INF file and edit it to match the built output.
+ 1. Open the INF file.
+ 2. In the Version section, add a reference to a catalog file like this: CatalogFile=XpsDrvSmpl.cat.
+ 3. In the SourceDisksFiles section, change the location of the DLL files you are building to =1. This indicates that there is no architecture specific directory in this driver. If you ship multiple architectures simultaneously, you will need to collate the driver INF manually.
-At this point, Visual Studio 2015 will be able to build a driver package and output the files to disk. In order to configure driver signing and deployment, see [Developing, Testing, and Deploying Drivers](http://msdn.microsoft.com/en-us/library/windows/hardware/ff554651(v=vs.85).aspx).
+At this point, Visual Studio 2017 will be able to build a driver package and output the files to disk. In order to configure driver signing and deployment, see [Developing, Testing, and Deploying Drivers](http://msdn.microsoft.com/en-us/library/windows/hardware/ff554651(v=vs.85).aspx).
**Note** If you compile your sample driver with Microsoft Visual Studio version 10, or 11 with the \_DEBUG flag set, then you should not use CComVariant on the following two XPS Print Filter Pipeline properties: