rewrite comments into one, unified style

code/public/ntlite/ddi/io_driver.h

@@ -1,6 +1,8 @@
+// Public NTLite io driver ABI declarations shared between kernel, drivers, and user mode.
+
 #pragma once
 // io_driver.h - kernel driver/device I/O model
-//
+
 // Device lifetime is owned by the I/O manager. Bus drivers create PDOs,
 // function/filter drivers attach FDOs, and PnP/remove IRPs tear stacks down.
 // Disk indexes are only a compatibility namespace above DEVICE_OBJECTs.
@@ -27,9 +29,7 @@ typedef KSTATUS (*PDRIVER_DISPATCH)(DEVICE_OBJECT* device, IRP* irp);
 typedef KSTATUS (*PDRIVER_ADD_DEVICE)(DRIVER_OBJECT* driver,
                                       DEVICE_OBJECT* physicalDeviceObject);
 
-// -------------------------------------------------------------------------
-// Bus / identity
-// -------------------------------------------------------------------------
+// Bus / identity.
 
 typedef enum IO_BUS_TYPE {
     IoBusUnknown = 0,
@@ -51,9 +51,7 @@ typedef struct IO_DRIVER_ID_TABLE {
 #define IO_MAX_DEVICE_ID_CHARS 96u
 #define IO_MAX_DEVICE_NAME_CHARS 64u
 
-// -------------------------------------------------------------------------
-// Driver/device objects
-// -------------------------------------------------------------------------
+// Driver/device objects.
 
 typedef enum DEVICE_OBJECT_TYPE {
     DeviceObjectPhysical = 1,
@@ -128,9 +126,7 @@ struct DEVICE_OBJECT {
 #define DEVICE_OBJECT_DISK       0x00000001u
 #define DEVICE_OBJECT_REMOVABLE  0x00000002u
 
-// -------------------------------------------------------------------------
-// Object/device creation and stack management
-// -------------------------------------------------------------------------
+// Object/device creation and stack management.
 
 __declspec(dllexport) void    IoInitializeDriverObject(DRIVER_OBJECT* driver,
                                                        SYS_STRING_VIEW name);
@@ -165,9 +161,7 @@ __declspec(dllexport) uint8_t IoGetDeviceStackSize(DEVICE_OBJECT* device);
 __declspec(dllexport) KSTATUS IoSendPnpIrpSync(DEVICE_OBJECT* device,
                                                 IO_PNP_MINOR_FUNCTION minor);
 
-// -------------------------------------------------------------------------
-// Disk namespace above storage DEVICE_OBJECTs
-// -------------------------------------------------------------------------
+// Disk namespace above storage DEVICE_OBJECTs.
 
 typedef enum IO_DEVICE_CHANGE {
     IoDeviceArrived = 0,