FireSync API
 All Classes Files Functions Variables Typedefs Friends Macros Modules Pages
kPxBlock.h
Go to the documentation of this file.
1 
8 #ifndef K_FIRESYNC_PX_BLOCK_H
9 #define K_FIRESYNC_PX_BLOCK_H
10 
11 #include <kFireSync/kNodeDef.h>
12 
19 //typedef kObject kPxBlock; --forward-declared in kFsDef.x.h
20 
30  kFsFx(const kChar*) kPxBlock_Description(kType type);
31 
47 kFsFx(kStatus) kPxBlock_Construct(kPxBlock* block, kType type, const kChar* name, k32u nodeId, k32u blockId, kPxEnviron pipeEnviron, kAlloc allocator);
48 
65 kFsFx(kStatus) kPxBlock_AssignGroup(kPxBlock block, k32u groupId);
66 
76 kFsFx(kBool) kPxBlock_IsGrouped(kPxBlock block);
77 
87 kFsFx(k32u) kPxBlock_GroupId(kPxBlock block);
88 
101 kFsFx(kStatus) kPxBlock_SetSendHandler(kPxBlock block, kCallbackFx function, kPointer receiver);
102 
115 kFsFx(kStatus) kPxBlock_SetDropHandler(kPxBlock block, kCallbackFx function, kPointer receiver);
116 
129 kFsFx(kStatus) kPxBlock_DefineInput(kPxBlock block, const kChar* name, k32u id, kPxPort* port);
130 
143 kFsFx(kStatus) kPxBlock_DefineOutput(kPxBlock block, const kChar* name, k32u id, kPxPort* port);
144 
165 kFsFx(kStatus) kPxBlock_EnableQueuedInputs(kPxBlock block, kBool enabled);
166 
177 kFsFx(kXml) kPxBlock_Settings(kPxBlock block);
178 
189 kFsFx(kStatus) kPxBlock_Setup(kPxBlock block);
190 
201 kFsFx(kStatus) kPxBlock_Start(kPxBlock block);
202 
214 kFsFx(kStatus) kPxBlock_Engage(kPxBlock block);
215 
226 kFsFx(kStatus) kPxBlock_Stop(kPxBlock block);
227 
240 kFsFx(kStatus) kPxBlock_Process(kPxBlock block, kPxPort port, kMsgInfo msgInfo);
241 
249 kFsFx(kStatus) kPxBlock_OnSetup(kPxBlock block);
250 
258 kFsFx(kStatus) kPxBlock_OnStart(kPxBlock block);
259 
284 kFsFx(kStatus) kPxBlock_OnEngage(kPxBlock block);
285 
293 kFsFx(kStatus) kPxBlock_OnStop(kPxBlock block);
294 
307 kFsFx(kStatus) kPxBlock_OnReceive(kPxBlock block, kPxPort port, kMsgSet msg);
308 
324 kFsFx(kStatus) kPxBlock_FilePath(kPxBlock block, const kChar* fileName, kChar* filePath, kSize capacity);
325 
340 kFsFx(kStatus) kPxBlock_FindVariable(kPxBlock block, const kChar* name, kObject* object);
341 
377 kFsFx(kStatus) kPxBlock_Send(kPxBlock block, kPxPort port, kMsgSet msg);
378 
389 kFsFx(kStatus) kPxBlock_Printf(kPxBlock block, const kChar* format, ...);
390 
404 kFsFx(kStatus) kPxBlock_NotifyDrop(kPxBlock block);
405 
418 kFsFx(kAlloc) kPxBlock_MessageAlloc(kPxBlock block);
419 
434 kFsFx(kHealth) kPxBlock_Health(kPxBlock block);
435 
449 kFsFx(k64u) kPxBlock_Timestamp(kPxBlock block);
450 
462 kFsFx(kMsgSource) kPxBlock_Sender(kPxBlock block);
463 
473 kFsFx(const kChar*) kPxBlock_Name(kPxBlock block);
474 
484 kFsFx(k32u) kPxBlock_Id(kPxBlock block);
485 
497 kFsFx(kStatus) kPxBlock_FindPort(kPxBlock block, k32u id, kPxPort* port);
498 
508 kFsFx(kSize) kPxBlock_PortCount(kPxBlock block);
509 
520 kFsFx(kPxPort) kPxBlock_PortAt(kPxBlock block, kSize index);
521 
531 kFsFx(kBool) kPxBlock_HasAllInputs(kPxBlock block);
532 
547 
562 
577 
578 #include <kFireSync/Pipe/kPxBlock.x.h>
579 
580 #endif
kXml kPxBlock_Settings(kPxBlock block)
Returns the block's internal settings.
Represents a kPxBlock port.
kStatus kPxBlock_OnSetup(kPxBlock block)
Virtual method that can be overridden to perform custom block setup.
kStatus kPxBlock_SetSendHandler(kPxBlock block, kCallbackFx function, kPointer receiver)
Sets a callback to receive messages sent by this block.
kStatus kPxBlock_Setup(kPxBlock block)
Executes a block's OnSetup method.
Represents information about the source of a pipe message.
Definition: kNodeDef.h:2508
kStatus kPxBlock_DefineInput(kPxBlock block, const kChar *name, k32u id, kPxPort *port)
Defines an input port for a block.
kPxPort kPxBlock_PortAt(kPxBlock block, kSize index)
Gets the port at the specified index.
kStatus kPxBlock_Send(kPxBlock block, kPxPort port, kMsgSet msg)
Sends a message on a specific port.
kStatus kPxBlock_Printf(kPxBlock block, const kChar *format,...)
Prints a diagnostic message.
kStatus kPxBlock_Process(kPxBlock block, kPxPort port, kMsgInfo msgInfo)
Executes a block's OnReceive method.
kBitArray kPxBlock_ThreadAffinity(kPxBlock block)
Reports the configured pipe thread affinity.
k32u kPxBlock_Id(kPxBlock block)
Gets the unique numeric identifier for this block instance.
Represents an object that provides external services to a pipe execution engine.
kSize kPxBlock_PortCount(kPxBlock block)
Gets the number of ports belonging to the block.
kMsgSource kPxBlock_Sender(kPxBlock block)
Returns information about the source of the message currently being processed.
kStatus kPxBlock_OnReceive(kPxBlock block, kPxPort port, kMsgSet msg)
Virtual method that can be overridden to perform custom actions when a messages is received...
const kChar * kPxBlock_Name(kPxBlock block)
Gets a descriptive name for the block instance.
kStatus kPxBlock_SetDropHandler(kPxBlock block, kCallbackFx function, kPointer receiver)
Sets a callback to provide notifications when this block drops a message.
k32s kPxBlock_ThreadPriorityOffset(kPxBlock block)
Reports the configured pipe thread priority offset.
kStatus kPxBlock_Start(kPxBlock block)
Executes a block's OnStart method.
Essential declarations related to FireSync nodes.
Abstract base class for pipe block implementations.
kStatus kPxBlock_Stop(kPxBlock block)
Executes a block's OnStop method.
kHealth kPxBlock_Health(kPxBlock block)
Gets a health service provider that can be used when constructing health or profiling probes...
kThreadPriorityClass kPxBlock_ThreadPriorityClass(kPxBlock block)
Reports the configured pipe thread priority class.
kStatus kPxBlock_NotifyDrop(kPxBlock block)
Notifies the processing environment that this block has dropped data.
k32u kPxBlock_GroupId(kPxBlock block)
Gets the processing group id associated with this block.
Base class for a health statistics collection service.
kStatus kPxBlock_Construct(kPxBlock *block, kType type, const kChar *name, k32u nodeId, k32u blockId, kPxEnviron pipeEnviron, kAlloc allocator)
Factory constructor for block objects.
kStatus kPxBlock_OnEngage(kPxBlock block)
Virtual method that can be overridden to perform custom actions when a block is engaged.
kStatus kPxBlock_FindPort(kPxBlock block, k32u id, kPxPort *port)
Finds the port object corresponding to the given id.
kStatus kPxBlock_Engage(kPxBlock block)
Executes a block's OnEngage method.
kStatus kPxBlock_FilePath(kPxBlock block, const kChar *fileName, kChar *filePath, kSize capacity)
Gets the full path for a given file name used by this block.
kAlloc kPxBlock_MessageAlloc(kPxBlock block)
Gets an allocator that should be used to construct output messages.
kBool kPxBlock_HasAllInputs(kPxBlock block)
For blocks with queued inputs, reports whether each input has at least one message available...
k64u kPxBlock_Timestamp(kPxBlock block)
Within an embedded node environment, this method can be used to access the current FireSync synchnron...
const kChar * kPxBlock_Description(kType type)
Given a kPxBlock subclass type, gets a description of the class.
Abstract base class for FireSync data messages.
kBool kPxBlock_IsGrouped(kPxBlock block)
Reports whether this block is assigned to a processing group.
kStatus kPxBlock_OnStart(kPxBlock block)
Virtual method that can be overridden to perform custom actions when a block is started.
kStatus kPxBlock_FindVariable(kPxBlock block, const kChar *name, kObject *object)
Gets a reference to a named object.
kStatus kPxBlock_EnableQueuedInputs(kPxBlock block, kBool enabled)
Enables the use of queued input ports.
kStatus kPxBlock_OnStop(kPxBlock block)
Virtual method that can be overridden to perform custom actions when a block is stopped.
Represents message source information and an attached message.
kStatus kPxBlock_AssignGroup(kPxBlock block, k32u groupId)
Assigns this block to a processing group.
kStatus kPxBlock_DefineOutput(kPxBlock block, const kChar *name, k32u id, kPxPort *port)
Defines an output port for a block.