[bus] Minor style/cosmetic changes
[people/sha0/winvblock.git] / src / include / bus.h
index 0c08509..e545f45 100644 (file)
@@ -18,8 +18,8 @@
  * You should have received a copy of the GNU General Public License
  * along with WinVBlock.  If not, see <http://www.gnu.org/licenses/>.
  */
-#ifndef _bus_h
-#  define _bus_h
+#ifndef _BUS_H
+#  define _BUS_H
 
 /**
  * @file
  * Bus specifics.
  */
 
-winvblock__def_struct ( bus__type )
-{
-  device__type_ptr device;
-  PDEVICE_OBJECT LowerDeviceObject;
-  PDEVICE_OBJECT PhysicalDeviceObject;
-  winvblock__uint32 Children;
-  device__type_ptr first_child_ptr;
-  KSPIN_LOCK SpinLock;
-  LIST_ENTRY tracking;
-  winvblock__any_ptr ext;
-  device__free_func * prev_free;
-  UNICODE_STRING dev_name;
-  UNICODE_STRING dos_dev_name;
-  winvblock__bool named;
-};
+winvblock__def_struct(bus__type) {
+    device__type_ptr device;
+    PDEVICE_OBJECT LowerDeviceObject;
+    PDEVICE_OBJECT PhysicalDeviceObject;
+    winvblock__uint32 Children;
+    device__type_ptr first_child_ptr;
+    KSPIN_LOCK SpinLock;
+    LIST_ENTRY tracking;
+    winvblock__any_ptr ext;
+    device__free_func * prev_free;
+    UNICODE_STRING dev_name;
+    UNICODE_STRING dos_dev_name;
+    winvblock__bool named;
+  };
 
-extern NTSTATUS STDCALL Bus_GetDeviceCapabilities (
-  IN PDEVICE_OBJECT DeviceObject,
-  IN PDEVICE_CAPABILITIES DeviceCapabilities
- );
+extern NTSTATUS STDCALL Bus_GetDeviceCapabilities(
+    IN PDEVICE_OBJECT DeviceObject,
+    IN PDEVICE_CAPABILITIES DeviceCapabilities
 );
 
 /**
- * Initialize the global, bus-common environment
+ * Initialize the global, bus-common environment.
  *
- * @ret ntstatus        STATUS_SUCCESS or the NTSTATUS for a failure
+ * @ret ntstatus        STATUS_SUCCESS or the NTSTATUS for a failure.
  */
-extern NTSTATUS bus__init (
-  void
- );
+extern NTSTATUS bus__init(void);
 
 /**
- * Tear down the global, bus-common environment
+ * Tear down the global, bus-common environment.
  */
-extern void bus__finalize (
-  void
- );
+extern void bus__finalize(void);
 
 /**
- * Create a new bus
+ * Create a new bus.
  *
- * @ret bus_ptr         The address of a new bus, or NULL for failure
+ * @ret bus_ptr         The address of a new bus, or NULL for failure.
  *
  * This function should not be confused with a PDO creation routine, which is
  * actually implemented for each device type.  This routine will allocate a
  * bus__type, track it in a global list, as well as populate the bus
  * with default values.
  */
-extern winvblock__lib_func bus__type_ptr bus__create (
-  void
- );
+extern winvblock__lib_func bus__type_ptr bus__create(void);
 
 /**
- * Add a child node to the bus
+ * Add a child node to the bus.
  *
- * @v bus_ptr           Points to the bus receiving the child
- * @v dev_ptr           Points to the child device to add
+ * @v bus_ptr           Points to the bus receiving the child.
+ * @v dev_ptr           Points to the child device to add.
  *
- * Returns TRUE for success, FALSE for failure
+ * Returns TRUE for success, FALSE for failure.
  */
-extern winvblock__lib_func winvblock__bool STDCALL bus__add_child (
-  IN OUT bus__type_ptr bus_ptr,
-  IN device__type_ptr dev_ptr
- );
+extern winvblock__lib_func winvblock__bool STDCALL bus__add_child(
+    IN OUT bus__type_ptr bus_ptr,
+    IN device__type_ptr dev_ptr
 );
 
 /**
  * Get a pointer to the bus device's extension space.
@@ -100,4 +93,4 @@ extern winvblock__lib_func bus__type_ptr bus__boot(void);
 
 extern winvblock__lib_func bus__type_ptr bus__get(device__type_ptr dev);
 
-#endif                         /* _bus_h */
+#endif  /* _BUS_H */