You are here: Part 3: Advanced Concepts > Built-In Topics > Built-in DataReaders > LOCATOR_FILTER QoS Policy (DDS Extension)

LOCATOR_FILTER QoS Policy (DDS Extension)

The LocatorFilter QoS Policy is only applicable to the built-in topic for a Publication (see ).

DDS_LocatorFilterQosPolicy

Type

Field Name

Description

DDS_
LocatorFilterSeq

locator_
filters

A sequence of locator filters, described in . There is one locator filter per DataWriter channel. If the length of the sequence is zero, the DataWriter is not using multi-channel.

char *

filter_
name

Name of the filter class used to describe the locator filter expressions. The following two values are supported:

  • DDS_SQLFILTER_NAME

  • DDS_STRINGMATCHFILTER_NAME

DDS_LocatorFilter_t

Type

Field Name

Description

DDS_
LocatorSeq

locators

A sequence of multicast address locators for the locator filter. See .

char *

filter_
expression

A logical expression used to determine if the data will be published in the channel associated with this locator filter. See SQL Filter Expression Notation and STRINGMATCH Filter Expression Notation for information about the expression syntax.

 

DDS_Locator_t

Type

Field Name

Description

DDS_Long

kind

If the locator kind is DDS_LOCATOR_KIND_UDPv4, the address contains an IPv4 address. The leading 12 octets of the address must be zero. The last 4 octets store the IPv4 address.

If the locator kind is DDS_LOCATOR_KIND_UDPv6, the address contains an IPv6 address. IPv6 addresses typically use a shorthand hexadecimal notation that maps one-to-one to the 16 octets of the address.

In C#, the locator kinds for UDPv4 and UDPv6 addresses are Locator_t.LOCATOR_KIND_UDPv4 and Locator_t.LOCATOR_KIND_UDPv6.

DDS_Octet
[16]

address

The locator address.

DDS_
UnsignedLong

port

The locator port number.

© 2016 RTI