Reference

ACE_Message_Queue_Factory(3)

ACE_Message_Queue_Factory is a static factory class template which provides a separate factory method for each of the major kinds of priority based message dispatching: static, earliest deadline first (EDF), and minimum laxity first (MLF).

NAME

ACE_Message_Queue_Factory - ACE_Message_Queue_Factory is a static factory class template which provides a separate factory method for each of the major kinds of priority based message dispatching: static, earliest deadline first (EDF), and minimum laxity first (MLF).

SYNOPSIS

#include <ace/Message_Queue_T.h>
template<ACE_SYNCH_DECL>
class ACE_Message_Queue_Factory
{
  public:
    create_static_message_queue (
        size_t hwm = ACE_Message_Queue_Base::DEFAULT_HWM,
        size_t lwm = ACE_Message_Queue_Base::DEFAULT_LWM,
        ACE_Notification_Strategy * = 0
        );
    create_deadline_message_queue (
        size_t hwm = ACE_Message_Queue_Base::DEFAULT_HWM,
        size_t lwm = ACE_Message_Queue_Base::DEFAULT_LWM,
        ACE_Notification_Strategy * = 0,
        u_long static_bit_field_mask = 0x3FFUL,
        u_long static_bit_field_shift = 10,
        u_long dynamic_priority_max = 0x3FFFFFUL,
        u_long dynamic_priority_offset = 0x200000UL
        );
    create_laxity_message_queue (
        size_t hwm = ACE_Message_Queue_Base::DEFAULT_HWM,
        size_t lwm = ACE_Message_Queue_Base::DEFAULT_LWM,
        ACE_Notification_Strategy * = 0,
        u_long static_bit_field_mask = 0x3FFUL,
        u_long static_bit_field_shift = 10,
        u_long dynamic_priority_max = 0x3FFFFFUL,
        u_long dynamic_priority_offset = 0x200000UL
        );
    create_Vx_message_queue (
        size_t max_messages,
        size_t max_message_length,
        ACE_Notification_Strategy *ns = 0
        );
    create_NT_message_queue (size_t max_threads);
};

DESCRIPTION

The ACE_Dynamic_Message_Queue class assumes responsibility for releasing the resources of the strategy with which it was constructed: the user of a message queue constructed by any of these factory methods is only responsible for ensuring destruction of the message queue itself.

PUBLIC MEMBERS

create_static_message_queue (
    size_t hwm = ACE_Message_Queue_Base::DEFAULT_HWM,
    size_t lwm = ACE_Message_Queue_Base::DEFAULT_LWM,
    ACE_Notification_Strategy * = 0
    );

factory method for a statically prioritized ACE_Message_Queue

create_deadline_message_queue (
    size_t hwm = ACE_Message_Queue_Base::DEFAULT_HWM,
    size_t lwm = ACE_Message_Queue_Base::DEFAULT_LWM,
    ACE_Notification_Strategy * = 0,
    u_long static_bit_field_mask = 0x3FFUL,
    u_long static_bit_field_shift = 10,
    u_long dynamic_priority_max = 0x3FFFFFUL,
    u_long dynamic_priority_offset = 0x200000UL
    );

factory method for a dynamically prioritized (by time to deadline) ACE_Dynamic_Message_Queue

create_laxity_message_queue (
    size_t hwm = ACE_Message_Queue_Base::DEFAULT_HWM,
    size_t lwm = ACE_Message_Queue_Base::DEFAULT_LWM,
    ACE_Notification_Strategy * = 0,
    u_long static_bit_field_mask = 0x3FFUL,
    u_long static_bit_field_shift = 10,
    u_long dynamic_priority_max = 0x3FFFFFUL,
    u_long dynamic_priority_offset = 0x200000UL
    );

factory method for a dynamically prioritized (by laxity) ACE_Dynamic_Message_Queue

create_Vx_message_queue (
    size_t max_messages,
    size_t max_message_length,
    ACE_Notification_Strategy *ns = 0
    );

factory method for a wrapped VxWorks message queue

create_NT_message_queue (size_t max_threads);

factory method for a NT message queue.

AUTHOR

Doug Schmidt

LIBRARY

ace