4.1.9. cmnGnGetSlaveInfoAll


SYNOPSIS

VT_I4 cmnGnGetSlaveInfoAll(
  [in] VT_I4 nDeviceNo,
  [in] VT_I4 nRingNo,
  [out] TCMNDevInfo pDevInfo
)

DESCRIPTION

  • 선택된 링 하위의 슬레이브 장치들에 대한 정보를 TCMNDevInfo 구조체를 통해서 전달 받습니다.

  • 구조체 내의 nTotalDevNumber 값은 nRingNo 에 의해서 선택된 링에 속한 슬레이브 모듈의 개수입니다.

PARAMETER

  • nDeviceNo : 링의 슬레이브 정보를 얻어올 마스터 디바이스를 번호를 지정합니다. 마스터 디바이스의 번호는 CPU 에 가까운 순으로 정해집니다.

  • nRingNo : 슬레이브의 정보를 얻어올 링의 번호를 지정합니다.

  • pDevInfo : TCMNDevInfo 구조체를 통해서 슬레이브의 정보를 반환 받습니다.

typedef struct _tagCMNDevInfo
{
  LONG nTotalDevNumber;
  TCMNSlaveInfo  SlaveInfo[MAX_RING][MAX_SLAVE];
} TCMNDevInfo;

typedef struct _tagCMNSlaveInfo
{
  LONG nDevNumber;
  UCHAR Use:1;
  UCHAR DevType:4;
  UCHAR Reserved:3;
} TCMNSlaveInfo;

▶ TCMNSlaveInfo 구조체

▶ nDevNumber : 해당 슬레이브가 속한 마스터 디바이스의 번호입니다.

▶ Use : 해당 슬레이브 모듈의 사용 여부를 나타냅니다.

▶ DevType정한 슬레이브 모듈의 디바이스 타입을 반환합니다. 반환값에 따른 슬레이브 모듈의 구분은 아래와 같습니다.

Value

Meaning

0

Digital 32 Output Slave Module.

1

Digital 8 Input 8 Output Slave Module.

2

Digital 16 Input 16 Output Slave Module.

4

Digital 32 Input Slave Module.

▶ Reserved : 예약 필드(여유분)입니다.

RETURN VALUE

Value

Meaning

음수

수행 실패. 자세한 내용은 ‘에러 코드’ 편을 참고합니다.

cmnERR_NONE

수행 성공