pdcomm_secs1_start

Function

Starts a created or stopped endpoint.

PdcommStatus pdcomm_secs1_start(PdcommSecs1Endpoint *endpoint)

Declared in: #include <pdcomm_secs1.h>

Starting never performs I/O. Starting after pdcomm_secs1_stop() creates a fresh protocol runtime, increments the generation, and restarts submission numbering at 1.

Parameters

Name	Description
endpoint	Endpoint to start.

Returns

#PDCOMM_OK on success; #PDCOMM_INVALID_ARGUMENT when endpoint is NULL; #PDCOMM_BACKPRESSURE when a staged event must be retrieved first; #PDCOMM_INVALID_STATE when the endpoint is already started, or on a wrong-thread, concurrent, or reentrant call; #PDCOMM_LIMIT_EXCEEDED when the generation counter is exhausted; #PDCOMM_ALLOCATION_FAILED when the new runtime cannot be allocated; #PDCOMM_LICENSE_REQUIRED when no license grants the secs-gem module (the endpoint stays unstarted); #PDCOMM_POISONED when the endpoint is poisoned.

Notes

• Thread safety: call only on the creating thread.