Added device manager documentation skeleton to docs/ as well as samples output

docs/source/device_manager.rst

@@ -0,0 +1,50 @@
+Device Manager
+==============
+
+.. module:: windows.winobject.device_manager
+
+The :class:`DeviceManager` instance is accessible via :py:attr:`windows.system.device_manager
+<windows.winobject.system.System.device_manager>`
+
+.. note::
+
+    See sample at :ref:`sample_device_manager`
+
+
+
+DeviceManager
+"""""""""""""
+
+
+.. autoclass:: DeviceManager
+   :members:
+   :undoc-members:
+
+
+DeviceClass
+"""""""""""
+
+
+.. autoclass:: DeviceClass
+   :members:
+   :undoc-members:
+
+
+
+DeviceInformationSet
+""""""""""""""""""""
+
+
+.. autoclass:: DeviceInformationSet
+   :members:
+   :undoc-members:
+
+
+
+DeviceInstance
+""""""""""""""
+
+
+.. autoclass:: DeviceInformationSet
+   :members:
+   :undoc-members:

docs/source/sample.rst

@@ -162,6 +162,27 @@ Output
 .. literalinclude:: samples_output\object_manager_findobj.txt
 
 
+.. _sample_device_manager:
+
+Device manager
+""""""""""""""
+
+.. literalinclude:: ..\..\samples\device_manager\device_manager.py
+
+Output
+
+.. literalinclude:: samples_output\device_manager_device_manager.txt
+
+
+Enumerate devices
+'''''''''''''''''
+
+.. literalinclude:: ..\..\samples\device_manager\enum_devices.py
+
+
+.. literalinclude:: samples_output\device_manager_enum_devices.txt
+
+
 .. _sample_wintrust:
 
 ``windows.wintrust``

docs/source/samples_output/device_manager_device_manager.txt

@@ -0,0 +1,19 @@
+(cmd) python device_manager\device_manager.py
+Device manager is <windows.winobject.device_manager.DeviceManager object at 0x00000000033442E8>
+Enumerating the first 3 device classes
+ * <DeviceClass name="XboxComposite" guid=05F5CFE2-4733-4950-A6BB-07AAD01A3A84>
+ * <DeviceClass name="DXGKrnl" guid=1264760F-A5C8-4BFE-B314-D56A7B44A362>
+ * <DeviceClass name="RemotePosDevice" guid=13E42DFA-85D9-424D-8646-28A70F864F9C>
+Finding device class 'System'
+  * <DeviceClass name="System" guid=4D36E97D-E325-11CE-BFC1-08002BE10318>
+  Enumerating some devices of 'System'
+    * <DeviceInstance "Motherboard resources" (id=1)>
+    * <DeviceInstance "Microsoft ACPI-Compliant Embedded Controller" (id=26)>
+        Enumerating allocated resources:
+          * <IoResource : [0x00000000000062-0x00000000000062]>
+          * <IoResource : [0x00000000000066-0x00000000000066]>
+    * <DeviceInstance "High Definition Audio Controller" (id=36)>
+        Enumerating allocated resources:
+          * <MemoryResource : [0x000000f7080000-0x000000f7083fff]>
+          * <DevicePrivateResource type=ResType_DevicePrivate(0x8001)>
+          * <IrqResource : [0x00000000000011]>

docs/source/samples_output/device_manager_enum_devices.txt

@@ -0,0 +1,34 @@
+$ python64 device_manager\enum_devices.py --no-print-devices
+Namespace(clsfilter=None, no_print_devices=True, print_resources=False)
+<DeviceClass name="XboxComposite" guid=05F5CFE2-4733-4950-A6BB-07AAD01A3A84>
+<DeviceClass name="DXGKrnl" guid=1264760F-A5C8-4BFE-B314-D56A7B44A362>
+<DeviceClass name="RemotePosDevice" guid=13E42DFA-85D9-424D-8646-28A70F864F9C>
+<DeviceClass name="DigitalMediaDevices" guid=14B62F50-3F15-11DD-AE16-0800200C9A66>
+<DeviceClass name="PrintQueue" guid=1ED2BBF9-11F0-4084-B21F-AD83A8E6DCDC>
+<DeviceClass name="WCEUSBS" guid=25DBCE51-6C8F-4A72-8A6D-B54C2B4FC835>
+<DeviceClass name="SecurityAccelerator" guid=268C95A1-EDFE-11D3-95C3-0010DC4050A5>
+<DeviceClass name="HidMsr" guid=2A9FE532-0CDC-44F9-9827-76192F2CA2FB>
+<DeviceClass name="SystemRecovery" guid=2DB15374-706E-4131-A0C7-D7C78EB0289A>
+....
+
+$ python64 device_manager\enum_devices.py --class Processor
+Namespace(clsfilter='Processor', no_print_devices=False, print_resources=False)
+<DeviceClass name="Processor" guid=50127DC3-0F36-415E-A6CC-4CB3BE910B65>
+  * <DeviceInstance "Intel Processor" (id=1)>
+  * <DeviceInstance "Intel Processor" (id=2)>
+  * <DeviceInstance "Intel Processor" (id=3)>
+  * <DeviceInstance "Intel Processor" (id=4)>
+
+
+$ python64 device_manager\enum_devices.py --class Display --print-resources
+Namespace(clsfilter='Display', no_print_devices=False, print_resources=True)
+<DeviceClass name="Display" guid=4D36E968-E325-11CE-BFC1-08002BE10318>
+  * <DeviceInstance "NVIDIA GeForce GTX 1070" (id=1)>
+    * <MemoryResource : [0x000000f6000000-0x000000f6ffffff]>
+    * <DevicePrivateResource type=ResType_DevicePrivate(0x8001)>
+    * <MemoryResource : [0x000000e0000000-0x000000efffffff]>
+    * <DevicePrivateResource type=ResType_DevicePrivate(0x8001)>
+    * <MemoryResource : [0x000000f0000000-0x000000f1ffffff]>
+    * <DevicePrivateResource type=ResType_DevicePrivate(0x8001)>
+    * <IoResource : [0x0000000000e000-0x0000000000e07f]>
+    ...

docs/source/winobject.rst

@@ -20,5 +20,6 @@ This sections describes them by group of relation.
     handle.rst
     system_module.rst
     object_manager.rst
+    device_manager.rst
     task_scheduler.rst
     evtlog.rst