rewrite comments into one, unified style

code/public/ntlite/ddi/display.h

@@ -1,6 +1,8 @@
+// Public NTLite display ABI declarations shared between kernel, drivers, and user mode.
+
 #pragma once
 // display.h - display device DDI
-//
+
 // Display providers register DISPLAY_DEVICE objects with the kernel display
 // manager.  The boot framebuffer backend is registered by the kernel itself;
 // PCI/virtual GPU drivers register additional providers later.

code/public/ntlite/ddi/hal_api.h

@@ -1,5 +1,7 @@
+// Public NTLite hal api ABI declarations shared between kernel, drivers, and user mode.
+
 #pragma once
-// hal_api.h - HAL interface table exported as HalGetApi()
+// hal_api.h - HAL interface table exported as HalGetApi().
 #include <stdint.h>
 #include <stdbool.h>
 #include <stddef.h>
@@ -100,19 +102,19 @@ typedef struct HAL_API {
 } HAL_API;
 
 typedef struct HAL_INIT_PARAMS {
-    // Framebuffer
+    // Framebuffer.
     uintptr_t  FramebufferBase;
     uint32_t   FramebufferWidth;
     uint32_t   FramebufferHeight;
     uint32_t   FramebufferStride;
 
-    // ACPI
+    // ACPI.
     uintptr_t  RsdpPhysical;
 
-    // Memory
+    // Memory.
     uint64_t   PhysicalWindowBase;
 
-    // Debug
+    // Debug.
     int        Debug;
 
     void*      (*AllocatePool)(size_t size);

code/public/ntlite/ddi/input_device.h

@@ -1,3 +1,5 @@
+// Public NTLite input device ABI declarations shared between kernel, drivers, and user mode.
+
 #pragma once
 // input_device.h - driver-facing input submission DDI.
 

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,

code/public/ntlite/ddi/net_abi.h

@@ -1,3 +1,5 @@
+// Public NTLite net abi ABI declarations shared between kernel, drivers, and user mode.
+
 #pragma once
 // net_abi.h - native networking ABI shared by the kernel socket facade
 // and network stack provider drivers.

code/public/ntlite/ddi/net_device.h

@@ -1,6 +1,8 @@
+// Public NTLite net device ABI declarations shared between kernel, drivers, and user mode.
+
 #pragma once
 // net_device.h - kernel network-device registry.
-//
+
 // NIC drivers register NET_DEVICE objects here and feed complete Ethernet
 // frames into NetReceiveFrame(). Protocol ownership belongs to whichever
 // network stack driver registered through net_stack.h.

code/public/ntlite/ddi/net_stack.h

@@ -1,6 +1,8 @@
+// Public NTLite net stack ABI declarations shared between kernel, drivers, and user mode.
+
 #pragma once
 // net_stack.h - provider interface between kernel socket facade and network stack drivers.
-//
+
 // The kernel owns process handles, user-memory copying, NET_DEVICE registration,
 // and SOCKET_OBJECT lifetime. A stack driver owns protocol implementation.
 

code/public/ntlite/ddi/pci.h

@@ -1,6 +1,8 @@
+// Public NTLite pci ABI declarations shared between kernel, drivers, and user mode.
+
 #pragma once
 // pci.h - PCI bus driver DDI exported by pci.sys
-//
+
 // Function drivers must not enumerate PCI or decode BARs themselves.  They bind
 // to PCI PDOs through the I/O manager and use these routines to access the PCI
 // function represented by their PDO.