hal: Mark outdated functions as deprecated

XboxDev · May 11, 2021 · 9d0482a · 9d0482a
1 parent 9519fbd
commit 9d0482a
Show file tree

Hide file tree

Showing 3 changed files with 10 additions and 1 deletion.
diff --git a/lib/hal/audio.h b/lib/hal/audio.h
@@ -31,7 +31,9 @@ typedef struct
 	int                      numChannels;
 } AC97_DEVICE  __attribute__ ((aligned (8)));
 
-// note that I currently ignore sampleSizeInBits and numChannels.  They
+// The XAudio API is only supposed to be used as a backend. Using SDL2 for 
+// audio playback should be prefered for applications.
+// note that currently sampleSizeInBits and numChannels are ignored. They
 // are provided to cope with future enhancements. Currently supported samples
 // are 16 bit, 2 channels (stereo)
 void XAudioInit(int sampleSizeInBits, int numChannels, XAudioCallback callback, void *data);

diff --git a/lib/hal/input.h b/lib/hal/input.h
@@ -11,6 +11,7 @@ extern "C"
 #endif
 
 /* General input functions */
+__attribute__((deprecated))
 void XInput_Init(void);
 void XInput_Init_Polling(void);
 void XInput_Quit(void);

diff --git a/lib/hal/io.h b/lib/hal/io.h
@@ -6,11 +6,17 @@ extern "C"
 {
 #endif
 
+__attribute__((deprecated))
 void IoOutputByte(unsigned short address, unsigned char value);
+__attribute__((deprecated))
 void IoOutputWord(unsigned short address, unsigned short value);
+__attribute__((deprecated))
 void IoOutputDword(unsigned short address, unsigned int value);
+__attribute__((deprecated))
 unsigned char IoInputByte(unsigned short address);
+__attribute__((deprecated))
 unsigned short IoInputWord(unsigned short address);
+__attribute__((deprecated))
 unsigned int IoInputDword(unsigned short address);
 
 #ifdef __cplusplus