]> sigrok.org Git - sigrok-util.git/blobdiff - source/drv-protocol.h
new-driver: Fix #include guard naming.
[sigrok-util.git] / source / drv-protocol.h
index c12e6ba6d11fe0194f45e559a9f4ff6ebfeda3b7..3f0cf65de0ebbd4b0e4713e75e5654a604607a56 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * This file is part of the sigrok project.
+ * This file is part of the libsigrok project.
  *
  * Copyright (C) ${year} ${author} <${email}>
  *
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
+#ifndef LIBSIGROK_HARDWARE_${upper}_PROTOCOL_H
+#define LIBSIGROK_HARDWARE_${upper}_PROTOCOL_H
 
-#ifndef LIBSIGROK_${upper}_H
-#define LIBSIGROK_${upper}_H
-
-/* Private, per-device-instance driver context. */
+/** Private, per-device-instance driver context. */
 struct dev_context {
+       /** The current sampling limit (in number of samples). */
        uint64_t limit_samples;
+
+       /** The current sampling limit (in ms). */
        uint64_t limit_msec;
 
-       /* Opaque pointer passed in by the frontend. */
+       /** Opaque pointer passed in by the frontend. */
        void *cb_data;
 
-       /* Runtime. */
+       /** The current number of already received samples. */
        uint64_t num_samples;
 };