rewrite comments into one, unified style

code/user/personalities/win32/winmm.c

@@ -1,12 +1,10 @@
-// winmm.c - Win32 multimedia: waveform audio, timer
-// Stubs only; no audio hardware access at this stage.
+// Win32 multimedia compatibility stubs. This file provides minimal timing and sound API entry points.
+
 #include <stdint.h>
 #include <stddef.h>
 #include <ntlite/syscall.h>
 
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
+// Types.
 typedef unsigned int  MMRESULT;
 typedef void*         HWAVEOUT;
 
@@ -48,17 +46,13 @@ typedef struct {
     } u;
 } MMTIME;
 
-// ---------------------------------------------------------------------------
-// Timer
-// ---------------------------------------------------------------------------
+// Timer.
 
 __declspec(dllexport) unsigned long timeGetTime(void) {
     return (unsigned long)(SysGetTick() / 1000u);
 }
 
-// ---------------------------------------------------------------------------
-// Waveform audio (stubs - no audio hardware at this stage)
-// ---------------------------------------------------------------------------
+// Waveform audio (stubs - no audio hardware at this stage).
 
 __declspec(dllexport) MMRESULT waveOutOpen(HWAVEOUT* phwo, unsigned int deviceId,
                                             const WAVEFORMATEX* fmt, uintptr_t callback,
@@ -68,6 +62,7 @@ __declspec(dllexport) MMRESULT waveOutOpen(HWAVEOUT* phwo, unsigned int deviceId
     return MMSYSERR_NOTSUPPORTED;
 }
 
+// Implements the wave Out Close operation.
 __declspec(dllexport) MMRESULT waveOutClose(HWAVEOUT hwo) {
     (void)hwo; return MMSYSERR_NOERROR;
 }
@@ -82,22 +77,27 @@ __declspec(dllexport) MMRESULT waveOutUnprepareHeader(HWAVEOUT hwo, WAVEHDR* hdr
     (void)hwo; (void)hdr; (void)size; return MMSYSERR_NOERROR;
 }
 
+// Implements the wave Out Write operation.
 __declspec(dllexport) MMRESULT waveOutWrite(HWAVEOUT hwo, WAVEHDR* hdr, unsigned int size) {
     (void)hwo; (void)hdr; (void)size; return MMSYSERR_NOTSUPPORTED;
 }
 
+// Implements the wave Out Pause operation.
 __declspec(dllexport) MMRESULT waveOutPause(HWAVEOUT hwo) {
     (void)hwo; return MMSYSERR_NOERROR;
 }
 
+// Implements the wave Out Restart operation.
 __declspec(dllexport) MMRESULT waveOutRestart(HWAVEOUT hwo) {
     (void)hwo; return MMSYSERR_NOERROR;
 }
 
+// Implements the wave Out Reset operation.
 __declspec(dllexport) MMRESULT waveOutReset(HWAVEOUT hwo) {
     (void)hwo; return MMSYSERR_NOERROR;
 }
 
+// Implements the wave Out Set Volume operation.
 __declspec(dllexport) MMRESULT waveOutSetVolume(HWAVEOUT hwo, unsigned long volume) {
     (void)hwo; (void)volume; return MMSYSERR_NOTSUPPORTED;
 }
@@ -109,16 +109,15 @@ __declspec(dllexport) MMRESULT waveOutGetPosition(HWAVEOUT hwo, MMTIME* mmt,
     return MMSYSERR_NOERROR;
 }
 
-// ---------------------------------------------------------------------------
 // Timer resolution control
 // No hardware timer reprogramming at this stage; pretend success so callers
 // that wrap their audio/game loop in timeBeginPeriod(1) don't bail out.
-// ---------------------------------------------------------------------------
 __declspec(dllexport) MMRESULT timeBeginPeriod(unsigned int uPeriod) {
     (void)uPeriod;
     return MMSYSERR_NOERROR;
 }
 
+// Implements the time End Period operation.
 __declspec(dllexport) MMRESULT timeEndPeriod(unsigned int uPeriod) {
     (void)uPeriod;
     return MMSYSERR_NOERROR;