VR-Link API Documentation for DIS
nullFedAmb1516.h
Go to the documentation of this file.
1 /*******************************************************************************
2 ** Copyright (c) 1992-2010 VT MAK
3 ** All rights reserved.
4 *******************************************************************************/
5 
6 
7 #if DtHLA
8 #if DtHLA_1516
9 #ifndef DtHLA_1516_EVOLVED
10 
13 
14 #pragma once
15 #include <RTI/Exception.h>
16 #include <RTI/FederateAmbassador.h>
17 
18 #include "rtiNamespace.h"
19 #include <vlutil/vlMachineTypes.h>
20 
21 class DT_DLL_VL DtNullFederateAmbassador : public RTI::FederateAmbassador
22 {
23 public:
24  DtNullFederateAmbassador()
25  throw (RTI::FederateInternalError) {};
26 
27  virtual
28  ~DtNullFederateAmbassador()
29  throw () {};
30 
31 protected:
32 
34  DtNullFederateAmbassador( const DtNullFederateAmbassador& src );
36  DtNullFederateAmbassador& operator=( const DtNullFederateAmbassador& src );
37 
38 public:
40  virtual
41  void
42  synchronizationPointRegistrationSucceeded(std::wstring const & label)
43  throw (RTI::FederateInternalError) {}
44 
45  virtual
46  void
47  synchronizationPointRegistrationFailed(std::wstring const & label,
48  RTI::SynchronizationFailureReason reason)
49  throw (RTI::FederateInternalError) {}
50 
52  virtual
53  void
54  announceSynchronizationPoint(std::wstring const & label,
55  RTI::VariableLengthData const & theUserSuppliedTag)
56  throw (RTI::FederateInternalError) {}
57 
59  virtual
60  void
61  federationSynchronized(std::wstring const & label)
62  throw (RTI::FederateInternalError) {}
63 
65  virtual
66  void
67  initiateFederateSave(std::wstring const & label)
68  throw (RTI::UnableToPerformSave,
69  RTI::FederateInternalError) {}
70 
71  virtual
72  void
73  initiateFederateSave(std::wstring const & label,
74  RTI::LogicalTime const & theTime)
75  throw (RTI::UnableToPerformSave,
76  RTI::InvalidLogicalTime,
77  RTI::FederateInternalError) {}
78 
80  virtual
81  void
82  federationSaved()
83  throw (RTI::FederateInternalError) {}
84 
85  virtual
86  void
87  federationNotSaved(RTI::SaveFailureReason theSaveFailureReason)
88  throw (RTI::FederateInternalError) {}
89 
90 
92  virtual
93  void
94  federationSaveStatusResponse(
95  RTI::FederateHandleSaveStatusPairVector const & theFederateStatusVector)
96  throw (RTI::FederateInternalError) {}
97 
99  virtual
100  void
101  requestFederationRestoreSucceeded(std::wstring const & label)
102  throw (RTI::FederateInternalError) {}
103 
104  virtual
105  void
106  requestFederationRestoreFailed(std::wstring const & label)
107  throw (RTI::FederateInternalError) {}
108 
110  virtual
111  void
112  federationRestoreBegun()
113  throw (RTI::FederateInternalError) {}
114 
116  virtual
117  void
118  initiateFederateRestore(std::wstring const & label,
119  RTI::FederateHandle handle)
120  throw (RTI::SpecifiedSaveLabelDoesNotExist,
121  RTI::CouldNotInitiateRestore,
122  RTI::FederateInternalError) {}
123 
125  virtual
126  void
127  federationRestored()
128  throw (RTI::FederateInternalError) {}
129 
130  virtual
131  void
132  federationNotRestored(RTI::RestoreFailureReason theRestoreFailureReason)
133  throw (RTI::FederateInternalError) {}
134 
136  virtual
137  void
138  federationRestoreStatusResponse(
139  RTI::FederateHandleRestoreStatusPairVector const & theFederateStatusVector)
140  throw (RTI::FederateInternalError) {}
141 
145 
147  virtual
148  void
149  startRegistrationForObjectClass(RTI::ObjectClassHandle theClass)
150  throw (RTI::ObjectClassNotPublished,
151  RTI::FederateInternalError) {}
152 
154  virtual
155  void
156  stopRegistrationForObjectClass(RTI::ObjectClassHandle theClass)
157  throw (RTI::ObjectClassNotPublished,
158  RTI::FederateInternalError) {}
159 
161  virtual
162  void
163  turnInteractionsOn(RTI::InteractionClassHandle theHandle)
164  throw (RTI::InteractionClassNotPublished,
165  RTI::FederateInternalError) {}
166 
168  virtual
169  void
170  turnInteractionsOff(RTI::InteractionClassHandle theHandle)
171  throw (RTI::InteractionClassNotPublished,
172  RTI::FederateInternalError) {}
173 
177 
179  virtual
180  void
181  objectInstanceNameReservationSucceeded(std::wstring const &
182  theObjectInstanceName)
183  throw (RTI::UnknownName,
184  RTI::FederateInternalError) {}
185 
186  virtual
187  void
188  objectInstanceNameReservationFailed(std::wstring const &
189  theObjectInstanceName)
190  throw (RTI::UnknownName,
191  RTI::FederateInternalError) {}
192 
193 
195  virtual
196  void
197  discoverObjectInstance(RTI::ObjectInstanceHandle theObject,
198  RTI::ObjectClassHandle theObjectClass,
199  std::wstring const & theObjectInstanceName)
200  throw (RTI::CouldNotDiscover,
201  RTI::ObjectClassNotKnown,
202  RTI::FederateInternalError) {}
203 
205  virtual
206  void
207  reflectAttributeValues
208  (RTI::ObjectInstanceHandle theObject,
209  RTI::AttributeHandleValueMap const & theAttributeValues,
210  RTI::VariableLengthData const & theUserSuppliedTag,
211  RTI::OrderType sentOrder,
212  RTI::TransportationType theType)
213  throw (RTI::ObjectInstanceNotKnown,
214  RTI::AttributeNotRecognized,
215  RTI::AttributeNotSubscribed,
216  RTI::FederateInternalError) {}
217 
218  virtual
219  void
220  reflectAttributeValues
221  (RTI::ObjectInstanceHandle theObject,
222  RTI::AttributeHandleValueMap const & theAttributeValues,
223  RTI::VariableLengthData const & theUserSuppliedTag,
224  RTI::OrderType sentOrder,
225  RTI::TransportationType theType,
226  RTI::RegionHandleSet const & theSentRegionHandleSet)
227  throw (RTI::ObjectInstanceNotKnown,
228  RTI::AttributeNotRecognized,
229  RTI::AttributeNotSubscribed,
230  RTI::FederateInternalError) {}
231 
232  virtual
233  void
234  reflectAttributeValues
235  (RTI::ObjectInstanceHandle theObject,
236  RTI::AttributeHandleValueMap const & theAttributeValues,
237  RTI::VariableLengthData const & theUserSuppliedTag,
238  RTI::OrderType sentOrder,
239  RTI::TransportationType theType,
240  RTI:: LogicalTime const & theTime,
241  RTI:: OrderType receivedOrder)
242  throw (RTI::ObjectInstanceNotKnown,
243  RTI::AttributeNotRecognized,
244  RTI::AttributeNotSubscribed,
245  RTI::FederateInternalError) {}
246 
247  virtual
248  void
249  reflectAttributeValues
250  (RTI::ObjectInstanceHandle theObject,
251  RTI::AttributeHandleValueMap const & theAttributeValues,
252  RTI::VariableLengthData const & theUserSuppliedTag,
253  RTI::OrderType sentOrder,
254  RTI::TransportationType theType,
255  RTI::LogicalTime const & theTime,
256  RTI::OrderType receivedOrder,
257  RTI::RegionHandleSet const & theSentRegionHandleSet)
258  throw (RTI::ObjectInstanceNotKnown,
259  RTI::AttributeNotRecognized,
260  RTI::AttributeNotSubscribed,
261  RTI::FederateInternalError) {}
262 
263  virtual
264  void
265  reflectAttributeValues
266  (RTI::ObjectInstanceHandle theObject,
267  RTI::AttributeHandleValueMap const & theAttributeValues,
268  RTI::VariableLengthData const & theUserSuppliedTag,
269  RTI::OrderType sentOrder,
270  RTI::TransportationType theType,
271  RTI::LogicalTime const & theTime,
272  RTI::OrderType receivedOrder,
273  RTI::MessageRetractionHandle theHandle)
274  throw (RTI::ObjectInstanceNotKnown,
275  RTI::AttributeNotRecognized,
276  RTI::AttributeNotSubscribed,
277  RTI::InvalidLogicalTime,
278  RTI::FederateInternalError) {}
279 
280  virtual
281  void
282  reflectAttributeValues
283  (RTI::ObjectInstanceHandle theObject,
284  RTI::AttributeHandleValueMap const & theAttributeValues,
285  RTI::VariableLengthData const & theUserSuppliedTag,
286  RTI::OrderType sentOrder,
287  RTI::TransportationType theType,
288  RTI::LogicalTime const & theTime,
289  RTI::OrderType receivedOrder,
290  RTI::MessageRetractionHandle theHandle,
291  RTI::RegionHandleSet const & theSentRegionHandleSet)
292  throw (RTI::ObjectInstanceNotKnown,
293  RTI::AttributeNotRecognized,
294  RTI::AttributeNotSubscribed,
295  RTI::InvalidLogicalTime,
296  RTI::FederateInternalError) {}
297 
299  virtual
300  void
301  receiveInteraction
302  (RTI::InteractionClassHandle theInteraction,
303  RTI::ParameterHandleValueMap const & theParameterValues,
304  RTI::VariableLengthData const & theUserSuppliedTag,
305  RTI::OrderType sentOrder,
306  RTI::TransportationType theType)
307  throw (RTI::InteractionClassNotRecognized,
308  RTI::InteractionParameterNotRecognized,
309  RTI::InteractionClassNotSubscribed,
310  RTI::FederateInternalError) {}
311 
312  virtual
313  void
314  receiveInteraction
315  (RTI::InteractionClassHandle theInteraction,
316  RTI::ParameterHandleValueMap const & theParameterValues,
317  RTI::VariableLengthData const & theUserSuppliedTag,
318  RTI::OrderType sentOrder,
319  RTI::TransportationType theType,
320  RTI::RegionHandleSet const & theSentRegionHandleSet)
321  throw (RTI::InteractionClassNotRecognized,
322  RTI::InteractionParameterNotRecognized,
323  RTI::InteractionClassNotSubscribed,
324  RTI::FederateInternalError) {}
325 
326  virtual
327  void
328  receiveInteraction
329  (RTI::InteractionClassHandle theInteraction,
330  RTI::ParameterHandleValueMap const & theParameterValues,
331  RTI::VariableLengthData const & theUserSuppliedTag,
332  RTI::OrderType sentOrder,
333  RTI::TransportationType theType,
334  RTI::LogicalTime const & theTime,
335  RTI::OrderType receivedOrder)
336  throw (RTI::InteractionClassNotRecognized,
337  RTI::InteractionParameterNotRecognized,
338  RTI::InteractionClassNotSubscribed,
339  RTI::FederateInternalError) {}
340 
341  virtual
342  void
343  receiveInteraction
344  (RTI::InteractionClassHandle theInteraction,
345  RTI::ParameterHandleValueMap const & theParameterValues,
346  RTI::VariableLengthData const & theUserSuppliedTag,
347  RTI::OrderType sentOrder,
348  RTI::TransportationType theType,
349  RTI::LogicalTime const & theTime,
350  RTI::OrderType receivedOrder,
351  RTI::RegionHandleSet const & theSentRegionHandleSet)
352  throw (RTI::InteractionClassNotRecognized,
353  RTI::InteractionParameterNotRecognized,
354  RTI::InteractionClassNotSubscribed,
355  RTI::FederateInternalError) {}
356 
357  virtual
358  void
359  receiveInteraction
360  (RTI::InteractionClassHandle theInteraction,
361  RTI::ParameterHandleValueMap const & theParameterValues,
362  RTI::VariableLengthData const & theUserSuppliedTag,
363  RTI::OrderType sentOrder,
364  RTI::TransportationType theType,
365  RTI::LogicalTime const & theTime,
366  RTI::OrderType receivedOrder,
367  RTI::MessageRetractionHandle theHandle)
368  throw (RTI::InteractionClassNotRecognized,
369  RTI::InteractionParameterNotRecognized,
370  RTI::InteractionClassNotSubscribed,
371  RTI::InvalidLogicalTime,
372  RTI::FederateInternalError) {}
373 
374  virtual
375  void
376  receiveInteraction
377  (RTI::InteractionClassHandle theInteraction,
378  RTI::ParameterHandleValueMap const & theParameterValues,
379  RTI::VariableLengthData const & theUserSuppliedTag,
380  RTI::OrderType sentOrder,
381  RTI::TransportationType theType,
382  RTI::LogicalTime const & theTime,
383  RTI::OrderType receivedOrder,
384  RTI::MessageRetractionHandle theHandle,
385  RTI::RegionHandleSet const & theSentRegionHandleSet)
386  throw (RTI::InteractionClassNotRecognized,
387  RTI::InteractionParameterNotRecognized,
388  RTI::InteractionClassNotSubscribed,
389  RTI::InvalidLogicalTime,
390  RTI::FederateInternalError) {}
391 
393  virtual
394  void
395  removeObjectInstance(RTI::ObjectInstanceHandle theObject,
396  RTI::VariableLengthData const & theUserSuppliedTag,
397  RTI::OrderType sentOrder)
398  throw (RTI::ObjectInstanceNotKnown,
399  RTI::FederateInternalError) {}
400 
401  virtual
402  void
403  removeObjectInstance(RTI::ObjectInstanceHandle theObject,
404  RTI::VariableLengthData const & theUserSuppliedTag,
405  RTI::OrderType sentOrder,
406  RTI::LogicalTime const & theTime,
407  RTI::OrderType receivedOrder)
408  throw (RTI::ObjectInstanceNotKnown,
409  RTI::FederateInternalError) {}
410 
411  virtual
412  void
413  removeObjectInstance(RTI::ObjectInstanceHandle theObject,
414  RTI::VariableLengthData const & theUserSuppliedTag,
415  RTI::OrderType sentOrder,
416  RTI::LogicalTime const & theTime,
417  RTI::OrderType receivedOrder,
418  RTI::MessageRetractionHandle theHandle)
419  throw (RTI::ObjectInstanceNotKnown,
420  RTI::InvalidLogicalTime,
421  RTI::FederateInternalError) {}
422 
424  virtual
425  void
426  attributesInScope
427  (RTI::ObjectInstanceHandle theObject,
428  RTI::AttributeHandleSet const & theAttributes)
429  throw (RTI::ObjectInstanceNotKnown,
430  RTI::AttributeNotRecognized,
431  RTI::AttributeNotSubscribed,
432  RTI::FederateInternalError) {}
433 
435  virtual
436  void
437  attributesOutOfScope
438  (RTI::ObjectInstanceHandle theObject,
439  RTI::AttributeHandleSet const & theAttributes)
440  throw (RTI::ObjectInstanceNotKnown,
441  RTI::AttributeNotRecognized,
442  RTI::AttributeNotSubscribed,
443  RTI::FederateInternalError) {}
444 
446  virtual
447  void
448  provideAttributeValueUpdate
449  (RTI::ObjectInstanceHandle theObject,
450  RTI::AttributeHandleSet const & theAttributes,
451  RTI::VariableLengthData const & theUserSuppliedTag)
452  throw (RTI::ObjectInstanceNotKnown,
453  RTI::AttributeNotRecognized,
454  RTI::AttributeNotOwned,
455  RTI::FederateInternalError) {}
456 
458  virtual
459  void
460  turnUpdatesOnForObjectInstance
461  (RTI::ObjectInstanceHandle theObject,
462  RTI::AttributeHandleSet const & theAttributes)
463  throw (RTI::ObjectInstanceNotKnown,
464  RTI::AttributeNotRecognized,
465  RTI::AttributeNotOwned,
466  RTI::FederateInternalError) {}
467 
469  virtual
470  void
471  turnUpdatesOffForObjectInstance
472  (RTI::ObjectInstanceHandle theObject,
473  RTI::AttributeHandleSet const & theAttributes)
474  throw (RTI::ObjectInstanceNotKnown,
475  RTI::AttributeNotRecognized,
476  RTI::AttributeNotOwned,
477  RTI::FederateInternalError) {}
478 
482 
484  virtual
485  void
486  requestAttributeOwnershipAssumption
487  (RTI::ObjectInstanceHandle theObject,
488  RTI::AttributeHandleSet const & theAttributes,
489  RTI::VariableLengthData const & theUserSuppliedTag)
490  throw (RTI::ObjectInstanceNotKnown,
491  RTI::AttributeNotRecognized,
492  RTI::AttributeAlreadyOwned,
493  RTI::AttributeNotPublished,
494  RTI::FederateInternalError) {}
495 
497  virtual
498  void
499  requestDivestitureConfirmation
500  (RTI::ObjectInstanceHandle theObject,
501  RTI::AttributeHandleSet const & theAttributes)
502  throw (RTI::ObjectInstanceNotKnown,
503  RTI::AttributeNotRecognized,
504  RTI::AttributeNotOwned,
505  RTI::AttributeDivestitureWasNotRequested,
506  RTI::FederateInternalError) {}
507 
509  virtual
510  void
511  attributeOwnershipAcquisitionNotification
512  (RTI::ObjectInstanceHandle theObject,
513  RTI::AttributeHandleSet const & theAttributes,
514  RTI::VariableLengthData const & theUserSuppliedTag)
515  throw (RTI::ObjectInstanceNotKnown,
516  RTI::AttributeNotRecognized,
517  RTI::AttributeAcquisitionWasNotRequested,
518  RTI::AttributeAlreadyOwned,
519  RTI::AttributeNotPublished,
520  RTI::FederateInternalError) {}
521 
523  virtual
524  void
525  attributeOwnershipUnavailable
526  (RTI::ObjectInstanceHandle theObject,
527  RTI::AttributeHandleSet const & theAttributes)
528  throw (RTI::ObjectInstanceNotKnown,
529  RTI::AttributeNotRecognized,
530  RTI::AttributeAlreadyOwned,
531  RTI::AttributeAcquisitionWasNotRequested,
532  RTI::FederateInternalError) {}
533 
535  virtual
536  void
537  requestAttributeOwnershipRelease
538  (RTI::ObjectInstanceHandle theObject,
539  RTI::AttributeHandleSet const & theAttributes,
540  RTI::VariableLengthData const & theUserSuppliedTag)
541  throw (RTI::ObjectInstanceNotKnown,
542  RTI::AttributeNotRecognized,
543  RTI::AttributeNotOwned,
544  RTI::FederateInternalError) {}
545 
547  virtual
548  void
549  confirmAttributeOwnershipAcquisitionCancellation
550  (RTI::ObjectInstanceHandle theObject,
551  RTI::AttributeHandleSet const & theAttributes)
552  throw (RTI::ObjectInstanceNotKnown,
553  RTI::AttributeNotRecognized,
554  RTI::AttributeAlreadyOwned,
555  RTI::AttributeAcquisitionWasNotCanceled,
556  RTI::FederateInternalError) {}
557 
559  virtual
560  void
561  informAttributeOwnership(RTI::ObjectInstanceHandle theObject,
562  RTI::AttributeHandle theAttribute,
563  RTI::FederateHandle theOwner)
564  throw (RTI::ObjectInstanceNotKnown,
565  RTI::AttributeNotRecognized,
566  RTI::FederateInternalError) {}
567 
568  virtual
569  void
570  attributeIsNotOwned(RTI::ObjectInstanceHandle theObject,
571  RTI::AttributeHandle theAttribute)
572  throw (RTI::ObjectInstanceNotKnown,
573  RTI::AttributeNotRecognized,
574  RTI::FederateInternalError) {}
575 
576  virtual
577  void
578  attributeIsOwnedByRTI(RTI::ObjectInstanceHandle theObject,
579  RTI::AttributeHandle theAttribute)
580  throw (RTI::ObjectInstanceNotKnown,
581  RTI::AttributeNotRecognized,
582  RTI::FederateInternalError) {}
583 
587 
589  virtual
590  void
591  timeRegulationEnabled(RTI::LogicalTime const & theFederateTime)
592  throw (RTI::InvalidLogicalTime,
593  RTI::NoRequestToEnableTimeRegulationWasPending,
594  RTI::FederateInternalError) {}
595 
597  virtual
598  void
599  timeConstrainedEnabled(RTI::LogicalTime const & theFederateTime)
600  throw (RTI::InvalidLogicalTime,
601  RTI::NoRequestToEnableTimeConstrainedWasPending,
602  RTI::FederateInternalError) {}
603 
605  virtual
606  void
607  timeAdvanceGrant(RTI::LogicalTime const & theTime)
608  throw (RTI::InvalidLogicalTime,
609  RTI::JoinedFederateIsNotInTimeAdvancingState,
610  RTI::FederateInternalError) {}
611 
613  virtual
614  void
615  requestRetraction(RTI::MessageRetractionHandle theHandle)
616  throw (RTI::FederateInternalError) {}
617 };
618 
619 #endif
620 #endif
621 #endif
622 
623 
Document ID: Generated on Wed Aug 14 15:35:11 EDT 2013 from SVN revision 130445
Copyright © 2005-2013 VT MÄK. All Rights Reserved (www.mak.com)