X-Git-Url: https://git.ucc.asn.au/?a=blobdiff_plain;f=Kernel%2Finclude%2Ftpl_drv_common.h;h=7608bc8ab7abe3cefd8b22edb488b4f2afd33c74;hb=75e87cf46a3899f76bae5c64e130cfc033562e9a;hp=31ad97a017cd6ce35e49937fde5cc18dcc17b59d;hpb=8bc40333b1401d7616b225945fee53d972c2f418;p=tpg%2Facess2.git

diff --git a/Kernel/include/tpl_drv_common.h b/Kernel/include/tpl_drv_common.h
index 31ad97a0..7608bc8a 100644
--- a/Kernel/include/tpl_drv_common.h
+++ b/Kernel/include/tpl_drv_common.h
@@ -1,8 +1,11 @@
+/*
+ * Acess2
+ * - Common Driver Interface
+ */
 /**
- AcessOS Version 1
- \file tpl_drv_common.h
- \brief Common Driver Interface Definitions
-*/
+ * \file tpl_drv_common.h
+ * \brief Common Driver Interface Definitions
+ */
 #ifndef _TPL_COMMON_H
 #define _TPL_COMMON_H
 
@@ -18,7 +21,7 @@ enum eTplDrv_IOCtl {
 	/// \brief Get driver version - (int *ver)
 	DRV_IOCTL_VERSION,
 	/// \brief Get a IOCtl from a symbolic name
-	DRV_IOCTL_LOOKUP,
+	DRV_IOCTL_LOOKUP
 };
 
 /**
@@ -39,6 +42,17 @@ enum eTplDrv_Type {
 };
 
 // === FUNCTIONS ===
+/**
+ * \fn int GetIOCtlId(int Class, char *Name)
+ * \brief Transforms a symbolic name into an ID
+ * \param Class	::eTplDrv_Type type to use
+ * \param Name	Symbolic name to resolve
+ * 
+ * This function is designed to be used by device drivers to implement
+ * ::eTplDrv_IOCtl.DRV_IOCTL_LOOKUP easily given that they conform to
+ * the standard interfaces (::eTplDrv_Type except DRV_TYPE_MISC) and do
+ * not add their own call numbers.
+ */
 extern int	GetIOCtlId(int Class, char *Name);
 
 #endif