CntGetNetCommunicationInfo

機能

Ethernetデバイスの通信状態を取得する関数です。マルチプロセス対応関数です。

書式

Ret = CntGetNetCommunicationInfo ( Id , InfoType , InfoData )

引数

Id [ C： short ] [ Python： ctypes.c_short ]
CntInitで取得したデバイスIDを指定します。

InfoType [ C： short ] [ Python： ctypes.c_short ]
取得する情報のタイプを指定します。情報のタイプは以下の定義値のいずれかの値です。

定義

値

[Dec]

意味

ICNT_NET_TYPE_REGISTER_PROCESS

プロセスの登録状況

InfoData [ C： long * ] [ Python： ctypes.POINTER(ctypes.c_long) ]
取得情報を格納する変数のアドレスを指定します。

戻り値

Ret [ C： long ] [ Python： ctypes.c_long ]

定義	値	意味
CNT_ERR_SUCCESS	0	正常終了
CNT_ERR_DLL_INVALID_ID	10001	無効なIDが指定されました
CNT_ERR_DLL_CALL_DRIVER	10002	ドライバを呼び出せません。(ioctlに失敗)
CNT_ERR_INFO_INVALID_INFOTYPE	10052	指定したデバイス情報タイプが範囲外です。
CNT_ERR_SYS_NOT_SUPPORTED	20001	このデバイスではこの関数は使用できません。

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

説明

Ethernetデバイスの通信状態を取得する関数です。
指定した情報タイプにより取得できる取得情報を以下に記載いたします。

プロセスの登録状況

関数を実行したプロセスがイベントの通知先としてデバイスに登録されているかどうかを確認できます。

定義

値

[Dec]

意味

CNT_IVALUE_PROCESS_UNREGISTERED

未登録

CNT_IVALUE_PROCESS_REGISTERED

登録済み

プロセスの登録が解除された場合、イベントは通知されなくなります。
イベント通知を再び行う場合、イベント通知設定を再度実行してください。

使用例

C	Ret = CntGetNetCommunicationInfo(Id, ICNT_NET_TYPE_REGISTER_PROCESS, &InfoData);
Python	Ret = ccnt.CntGetNetCommunicationInfo(Id, ccnt.ICNT_NET_TYPE_REGISTER_PROCESS, ctypes.byref(InfoData))