CanSetChannelAcceptance

機能

受信受容設定をします。

書式

Ret = CanSetChannelAcceptance ( Id , ChannelNo , MessageTypeMask , CanIdMask , CanIdCode )

引数

Id [ VB.NET： Short ] [ C, C++： short ] [ C#： short ] [ Python: ctypes.c_short ]
CanInitで取得したデバイスIDを指定します。

ChannelNo [ VB.NET： UShort ] [ C, C++： unsigned short ] [ C#： ushort ] [ Python: ctypes.c_ushort ]
チャネル番号を指定します。

MessageTypeMask [ VB.NET： UInteger ] [ C, C++： unsigned long ] [ C#： uint ] [ Python: ctypes.c_uint ]
受信しないメッセージタイプを指定します。
ビット指定されているメッセージタイプが受信対象外となります。

複数のメッセージタイプを指定する場合は、論理和(OR)でビット演算します。
例えば、0x00の場合、メッセージタイプの指定がないため、全メッセージタイプが受信対象となります。

CanIdMask [ VB.NET： UInteger ] [ C, C++： unsigned long ] [ C#： uint ] [ Python: ctypes.c_uint ]
受信対象とするCAN IDのマスク指定をします。

標準フォーマットが指定されている場合は、ベースID(11bit)で指定します。
有効な指定範囲は、0x000～0x7FFです。
0x000を指定すると、すべてのCAN IDメッセージが受信バッファに格納されます。
0x7FFを指定すると、すべてのCAN IDがフィルタ対象となり、CanIdCodeで受信バッファに格納するCAN IDメッセージを指定します。

拡張フォーマットが指定されている場合は、拡張ID + ベースID (合計29bit)で指定します。
有効な指定範囲は、0x000～0x1FFFFFFFです。
0x00000000を指定すると、すべてのCAN IDメッセージが受信バッファに格納されます。
0x1FFFFFFFを指定すると、すべてのCAN IDがフィルタ対象となり、CanIdCodeで受信バッファに格納するCAN IDメッセージを指定します。

CanIdCode [ VB.NET： UInteger ] [ C, C++： unsigned long ] [ C#： uint ] [ Python: ctypes.c_uint ]
CanIdMask指定でフィルタ対象となったメッセージの中で、受信バッファへ格納するCAN IDをコード指定します。

標準フォーマットが指定されている場合は、ベースID(11bit)で指定します。
有効な指定範囲は、0x000～0x7FFです。

拡張フォーマットが指定されている場合は、拡張ID + ベースID (合計29bit)で指定します。
拡張IDが上位ビット、ベースIDが下位ビットとなります。
有効な指定範囲は、0x000～0x1FFFFFFFです。

戻り値

Ret [ VB.NET： Integer ] [ C, C++： long ] [ C#： int ] [ Python: ctypes.c_long ]

その他のエラー（参照：エラーコード詳細）

初期値

MessageTypeMask = 0x00　（CCAN_MSG_TYPE_DISABLEL。指定なし（全メッセージタイプが受信対象とする） ）
CanIdMask = 0x00000000　（全メッセージが受信バッファへ格納されます）
CanIdCode = 0x00000000

説明

受信受容設定をします。

バス未接続時のみ設定可能です。

１つのCAN IDを受信対象とするだけでなく、CanIdMaskとCanIdCodeを組み合わせることで、複数のCAN IDを受信対象にすることができます。
詳細は、「CanIdMaskとCanIdCodeの設定例」を参照ください。

使用例

ChannelNo = 1へ、標準フォーマットのCAN通信で、CanIdMask = 2047、CanIdCode = 3に設定します。なお、10進数の2047を、16進数で表すと 0x7FFです。

関連項目

CanGetChannelAcceptance