Users Manual Instruction Manual

205
CATC BTTRAINER 2.11 CHAPTER
User’s Manual
HCISetEventFilter
HCISetEventFilter(FilterType, FilterConditionType,
Condition)
Return value
• “Success”
• “Failure”
• “Invalid parameter”
Comments
Instructs the Host Controller to send only certain types of events to the
Host.
Examples
# Clear All Filters
result = HCISetEventFilter(0);
Trace("Result of clearing all filters: ", result, "\n");
# Inquiry Result
result = HCISetEventFilter(1, 2,
[0xA,0x1,0x24,0x12,0xFB,0xAA]);
Trace("Result of Inquiry Result filter: ", result, "\n");
# Connection Setup
result = HCISetEventFilter(2, 0, [0x1]);
Trace("Result of Connection Setup filter: ", result, "\n");
Parameter Meaning Default Value Comments
FilterType Filter type:
0 = Clear all
filters;
1 = Inquiry
result;
2 = Connec-
tion setup;
3-255 =
Reserved
If value 0 is used, no other parameters should be
supplied.
Filter
Condition
Type
Type of filter
condition.
This parameter has different meanings depending
on the filter type.
Condition Details of the
filter to be set.
Must be entered as a series of bytes within brack-
ets, e.g., [0x1, 0x12, 0x0F]. Byte values must be
entered in hex notation separated by commas.