2.1.4. ceGnReSearchDevice¶
SYNOPSIS¶
VT_I4 ceGnReSearchDevice(
VT_I4 RealNode,
DWORD nTimeout,
VT_I4 IsBlocking,
VT_PI4 pResultNode
)
DESCRIPTION¶
원격 노드의 정보가 탐색된 상태에서 원격 노드의 정보를 재 탐색 합니다. ceGnIsSearchedDevice 함수를 통해 원격 노드 탐색 여부를 확인할 수 있습니다.
PARAMETER¶
RealNode : 실제 탐색(Search)할 원격 노드의 수를 설정합니다. RealNode 의 개수는 탐색할 원격. 노드의 개수보다 같거나 커야 합니다.
nTimeout : 원격 노드 탐색(Search) 시간을 밀리초(ms) 단위로 설정합니다. 1 개의 원격 노드를. 탐색하는데 걸리는 최소 시간은 30ms 입니다. 최소 탐색 시간은 다음과 같습니다.
원격 노드 개수 |
탐색 시간 |
|---|---|
1개 |
30ms*1 =30ms |
2개 |
30ms*2=60ms |
3개 |
30ms*3 =90ms |
Note
실제 탐색 시간이 너무 짧을 경우 요구되는 모든 원격 노드를 검색할 수 없으니, 탐색
시간을 충분히 설정해 주시기 바랍니다.
IsBlocking : 완료될 때까지 기다리는 동안 윈도우 메시지를 블록(Blocking)할 것인지를 결정합니다.
Value |
Meaning |
|---|---|
0 (CE_FALSE) |
블록(Blocking)을 하지 않습니다. 따라서 원격 노드 정보 탐색이 완료되는 동안에도 윈도우 이벤트를 처리합니다. |
1 (CE_TRUE) |
블록(Blocking)을 합니다. 따라서 원격 노드 정보 탐색이 완료되는 동안에는 윈도우 이벤트가 처리되지 않습니다. |
pResultNode : 이 매개변수를 통하여 탐색된 원격 노드의 수를 반환합니다.
Hint
㈜ 커미조아의 디바이스 초기값은 어떤 값으로 설정됩니까?
ceGnSearchDevice() 함수를 통해 탐색한 원격 노드 초기화 시 각 속성별로 사용되는 기본값은 “Appendix::C Motion Default Parameter”를 참조하시기 바랍니다.
RETURN VALUE¶
Value |
Meaning |
|---|---|
음수 |
수행 실패. 자세한 내용은 ‘에러 처리’ 편을 참고합니다. |
0 (ceERR_NONE) |
수행 성공 |