X-Git-Url: https://sigrok.org/gitweb/?a=blobdiff_plain;f=source%2Fdrv-protocol.h;h=3f0cf65de0ebbd4b0e4713e75e5654a604607a56;hb=6a94754feb0b2de80dfd367fcad556ab08b6540e;hp=c12e6ba6d11fe0194f45e559a9f4ff6ebfeda3b7;hpb=a65d66c08881d65a6d6e37be8efc1a24e4f60592;p=sigrok-util.git

diff --git a/source/drv-protocol.h b/source/drv-protocol.h
index c12e6ba..3f0cf65 100644
--- a/source/drv-protocol.h
+++ b/source/drv-protocol.h
@@ -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}>
  *
@@ -17,19 +17,21 @@
  * 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;
 };