IDS peak genericC++ v1.11.1
Loading...
Searching...
No Matches
peak_event_controller.hpp
Go to the documentation of this file.
1
10
11#pragma once
12
13
17#include <peak/dll_interface/peak_dll_interface_util.hpp>
19
20#include <cstddef>
21#include <cstdint>
22#include <memory>
23
24
25namespace peak
26{
27namespace core
28{
29
42{
43public:
47 EventController() = delete;
56 EventController(const EventController& other) = delete;
57 EventController& operator=(const EventController& other) = delete;
60
62 RawInformation Info(int32_t infoCommand) const;
63
73 size_t NumEventsInQueue() const;
74
84 uint64_t NumEventsFired() const;
85
95 size_t EventMaxSize() const;
96
106 size_t EventDataMaxSize() const;
107
127 std::unique_ptr<Event> WaitForEvent(Timeout timeout_ms);
128
150 void KillWait();
151
170
178 void FlushEvents();
179
188
189private:
190 friend ClassCreator<EventController>;
191 explicit EventController(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle);
192 PEAK_EVENT_CONTROLLER_HANDLE m_backendHandle;
193};
194
195} /* namespace core */
196} /* namespace peak */
197
198/* Implementation */
199namespace peak
200{
201namespace core
202{
203
205 : m_backendHandle(eventControllerHandle)
206{}
207
212
213inline RawInformation EventController::Info(int32_t infoCommand) const
214{
215 return QueryRawInformationFromCInterfaceFunction([&](int32_t* dataType, uint8_t* buffer, size_t* bufferSize) {
217 m_backendHandle, infoCommand, dataType, buffer, bufferSize);
218 });
219}
220
222{
223 return QueryNumericFromCInterfaceFunction<size_t>([&](size_t* numEventsInQueue) {
224 return PEAK_C_ABI_PREFIX PEAK_EventController_GetNumEventsInQueue(m_backendHandle, numEventsInQueue);
225 });
226}
227
228inline uint64_t EventController::NumEventsFired() const
229{
230 return QueryNumericFromCInterfaceFunction<uint64_t>([&](uint64_t* numEventsFired) {
231 return PEAK_C_ABI_PREFIX PEAK_EventController_GetNumEventsFired(m_backendHandle, numEventsFired);
232 });
233}
234
235inline size_t EventController::EventMaxSize() const
236{
237 return QueryNumericFromCInterfaceFunction<size_t>([&](size_t* eventMaxSize) {
238 return PEAK_C_ABI_PREFIX PEAK_EventController_GetEventMaxSize(m_backendHandle, eventMaxSize);
239 });
240}
241
243{
244 return QueryNumericFromCInterfaceFunction<size_t>([&](size_t* eventDataMaxSize) {
245 return PEAK_C_ABI_PREFIX PEAK_EventController_GetEventDataMaxSize(m_backendHandle, eventDataMaxSize);
246 });
247}
248
249inline std::unique_ptr<Event> EventController::WaitForEvent(Timeout timeout_ms)
250{
251 auto eventHandle = QueryNumericFromCInterfaceFunction<PEAK_EVENT_HANDLE>(
252 [&](PEAK_EVENT_HANDLE* _eventHandle) {
253 return PEAK_C_ABI_PREFIX PEAK_EventController_WaitForEvent(m_backendHandle, timeout_ms, _eventHandle);
254 });
255
256 return std::make_unique<ClassCreator<Event>>(eventHandle);
257}
258
260{
261 CallAndCheckCInterfaceFunction(
262 [&] { return PEAK_C_ABI_PREFIX PEAK_EventController_KillWait(m_backendHandle); });
263}
264
266{
267 CallAndCheckCInterfaceFunction(
268 [&] { return PEAK_C_ABI_PREFIX PEAK_EventController_FlushPendingKillWaits(m_backendHandle); });
269}
270
272{
273 CallAndCheckCInterfaceFunction(
274 [&] { return PEAK_C_ABI_PREFIX PEAK_EventController_FlushEvents(m_backendHandle); });
275}
276
278{
279 return static_cast<EventType>(
280 QueryNumericFromCInterfaceFunction<PEAK_EVENT_TYPE>([&](PEAK_EVENT_TYPE* controlledEventType) {
282 m_backendHandle, controlledEventType);
283 }));
284}
285
286} /* namespace core */
287} /* namespace peak */
void FlushEvents()
Discards all events in queue.
Definition peak_event_controller.hpp:271
EventType ControlledEventType() const
Returns the controlled event type.
Definition peak_event_controller.hpp:277
std::unique_ptr< Event > WaitForEvent(Timeout timeout_ms)
Blocking wait for an event.
Definition peak_event_controller.hpp:249
RawInformation Info(int32_t infoCommand) const
Delivers information based on the given GenTL info command.
Definition peak_event_controller.hpp:213
EventController()=delete
Can not be created on its own, instead use EnableEvents.
EventController & operator=(const EventController &other)=delete
void FlushPendingKillWaits()
Flushes the KillWait queue.
Definition peak_event_controller.hpp:265
size_t EventDataMaxSize() const
Returns the maximum size of the data of an event in bytes.
Definition peak_event_controller.hpp:242
~EventController()
Destroys the EventController and unregisters the event.
Definition peak_event_controller.hpp:208
void KillWait()
Cancels a pending WaitForEvent call.
Definition peak_event_controller.hpp:259
size_t NumEventsInQueue() const
Returns the number of events in queue.
Definition peak_event_controller.hpp:221
EventController(const EventController &other)=delete
EventController & operator=(EventController &&other)=delete
size_t EventMaxSize() const
Returns the maximum size of an event in bytes.
Definition peak_event_controller.hpp:235
uint64_t NumEventsFired() const
Returns the number of fired events.
Definition peak_event_controller.hpp:228
EventController(EventController &&other)=delete
Represents a timeout value in milliseconds.
Definition peak_timeout.hpp:31
The "core" namespace contains the direct GenAPI and GenTL wrapper.
Definition peak_buffer.hpp:31
EventType
Different types of events.
Definition peak_event.hpp:35
The "peak" namespace directly contains convenience functionality like the DeviceManager as well as th...
Definition peak_dynamic_loader.h:33
PEAK_C_API PEAK_EventController_FlushEvents(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle)
Tells the given event controller to flush all events in queue.
struct PEAK_EVENT * PEAK_EVENT_HANDLE
Definition peak_backend.h:485
int32_t PEAK_EVENT_TYPE
Definition peak_backend.h:185
PEAK_C_API PEAK_EventController_GetEventMaxSize(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, size_t *eventMaxSize)
Asks the event controller for the maximum size of an event.
struct PEAK_EVENT_CONTROLLER * PEAK_EVENT_CONTROLLER_HANDLE
Definition peak_backend.h:481
PEAK_C_API PEAK_EventController_GetEventDataMaxSize(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, size_t *eventDataMaxSize)
Asks the event controller for the maximum size of an event's data.
PEAK_C_API PEAK_EventController_GetInfo(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, int32_t infoCommand, int32_t *infoDataType, uint8_t *info, size_t *infoSize)
Asks the given event controller for an information based on a specific command.
PEAK_C_API PEAK_EventController_FlushPendingKillWaits(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle)
Flushes the KillWait queue.
PEAK_C_API PEAK_EventController_WaitForEvent(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, uint64_t timeout_ms, PEAK_EVENT_HANDLE *eventHandle)
Tells the given event controller to wait for an event with the given timeout.
PEAK_C_API PEAK_EventController_GetNumEventsInQueue(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, size_t *numEventsInQueue)
Asks the event controller for its number of events in queue.
PEAK_C_API PEAK_EventController_GetNumEventsFired(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, uint64_t *numEventsFired)
Asks the event controller for its number of fired events.
PEAK_C_API PEAK_EventController_GetControlledEventType(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, PEAK_EVENT_TYPE *controlledEventType)
Asks the event controller for its controlled event type.
PEAK_C_API PEAK_EventController_KillWait(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle)
Cancels a pending PEAK_EventController_WaitForEvent call.
PEAK_C_API PEAK_EventController_Destruct(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle)
Destroys the given event controller.
#define PEAK_C_ABI_PREFIX
Definition peak_dll_defines.h:16
The struct returned by all raw information functions.
Definition peak_common_structs.hpp:25