summaryrefslogtreecommitdiff
path: root/Sensors/SimpleDeviceOrientationSensor/Gallery.xml
blob: 8fbb8b8c0b889ba58e84a5da3b19b3882b3f435e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="../../buildx/script2/preview.xslt"?>
<gallery_sample xmlns="http://microsoft.com/wdcml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://microsoft.com/wdcml ../../buildx/schema/xsd/wdcml.xsd">
  <metadata id="gallery_samples.107a_gallery" type="gallery_sample" msdnID="7cba6311-f0db-4c3d-8f1f-25de8648b353">
    <title>SimpleDeviceOrientationSensor</title>
    <!-- Add a devlang for each programming language in all versions of the sample.  -->
    <devlang value="cpp" />
    <!-- Do not change tech value -->
    <tech value="gallery_samples" />
    <index />
    <sample_langs>
      <!-- Describes the languages to which the sample code itself has been localized. -->
      <sample_lang xml:lang="en-us" />
    </sample_langs>
  </metadata>
  <content>
    <desc>
      <p><abstract>The SimpleDeviceOrientationSensor sample shows how to write a UMDF v2 sensor driver to output Simple Device Orientation values.</abstract></p>
    </desc>
    <outline />
    <license_info>
      <default_license />
    </license_info>
    <programming_models>
      <programming_model value="win32" />
    </programming_models>
    <application_frameworks>
    </application_frameworks>
    <!-- For Driver Samples Only -->
    <driver_models>
      <!-- possible values: kmdf, umdf, wdm, ndis, wddm -->
      <driver_model value="UMDF" />
    </driver_models>
    <driver_techs>
      <driver_tech value="Windows Driver" />
    </driver_techs>
    <related_techs>
    </related_techs>
    <os_requirements>
      <min_os>
        <client name="winblue"/>
        <server name="wbluesrv"/>
      </min_os>
    </os_requirements>
    <required_sdks>
      <min_sdk>
        <tla rid="windows_driver_kit_8" />
      </min_sdk>
    </required_sdks>
    <supported_ides>
      <supported_ide>
        <tla rid="tla_visualstu2012" />
      </supported_ide>
    </supported_ides>
    <build_info>
      <authored_instructions>
        <section>
          <!-- Include any special instructions for compiling your sample -->
          <sectioncontents>
          </sectioncontents>
        </section>
      </authored_instructions>
    </build_info>
    <run_info>
      <authored_instructions>
        <section>
          <sectioncontents>
            <p>To install the sample driver, follow these steps:</p>
            <proch>
              <item>Ensure that the driver builds without errors.</item>
              <item>Copy the DLL and INF files to a separate folder.</item>
              <item>Enter the command "<inline_code devlang="cmd">devcon.exe update SimpleDeviceOrientationSensor.inf ACPI\&lt;HWID&gt;</inline_code>" to install the driver on an existing device node. You can find the devcon.exe program in the tools\devcon folder where you installed the WDK.</item>
            </proch>
          </sectioncontents>
        </section>
        <section>
          <title>File manifest</title>
          <sectioncontents>
            <p>The following source files are in the src\Sensors\SimpleDeviceOrientationSensor folder and are used to build the SimpleDeviceOrientationSensor.dll and SimpleDeviceOrientationSensor.inf files.</p>
            <table>
              <tr>
                <th>File</th>
                <th>Description</th>
              </tr>
              <tr>
                <td>
                  <p>device.h, device.cpp</p>
                </td>
                <td>
                  <p>Implements the driver's WDF PnP event callbacks and helper methods</p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>client.cpp</p>
                </td>
                <td>
                  <p>Implements the driver's callback functions from the class extension to simple device orientation sensors.</p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>driver.h, driver.cpp</p>
                </td>
                <td>
                  <p>WDF driver entry event callbacks and helper methods</p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>hardwaresimulator.h, hardwaresimulator.cpp</p>
                </td>
                <td>
                  <p>Hardware simulator implementation</p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>makefile.inc</p>
                </td>
                <td>
                  <p>Defines custom build actions. Includes the conversion of the .INX file into a .INF file.</p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>SensorsTrace.h</p>
                </td>
                <td>
                  <p>Implementation the sensor traces files.</p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>SimpleDeviceOrientationSensor.ctl</p>
                </td>
                <td>
                  <p>Declaration of driver's tracing GUID</p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>SimpleDeviceOrientationSensor.inx</p>
                </td>
                <td>
                  <p>Describes the installation of the driver. The build process converts this into a .INF.</p>
                </td>
              </tr>
            </table>
          </sectioncontents>
        </section>
      </authored_instructions>
    </run_info>
  </content>
  <!-- List the component compcentral path -->
  <feature_teams>
    <feature_team_info comp_central_path="CORE-OS Core\SiGMa-Silicon, Graphics and Media\SiPlat - Silicon Platform\Sensors" dev_owner="osamasal" writer_owner="ericdoku" />
  </feature_teams>
  <workflow_control_host />
</gallery_sample>