13.1.8. cesPeekByteEx

SYNOPSYS

t_i32 cesPeekByteEx(
      [in] t_i32 nNodeID,
      [in] t_i32 nChannel,
      [in] t_i32 nIndex,
      [out] ULONGLONG  byRetVal,
      [out] t_bool  bIsSuccess
  )

DESCRIPTION

  • 수신 버퍼 내 원하는 위치의 1 바이트 데이터를 읽어옵니다.

  • 모두 버퍼 카운트를 감소 시키지 않습니다.

PARAMETER

  • nNetID : 원격 노드 ID

  • nChannel : 채널 번호

  • nIndex : 수신 버퍼에서 읽어올 바이트에 대한 위치 인덱스 값을 설정

  • byRetVal : 읽은 바이트 데이터를 반환

  • bIsSuccess : 함수 수행 여부 반환

RETURN VALUE

  • 함수 수행 여부를 반환합니다.

Value

Meaning

음수

수행 실패

0 (ceERR_NONE)

수행 성공

EXAMPLE

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
#include "ceSDK.h"
#include "ceSDKDef.h"
long nSerialChNo = 0; // 시리얼 채널(Port) 번호
BYTE byData; // 1 바이트 데이터 정보

// 0 번 시리얼 포트에 대해 수신 버퍼의 첫번째 바이트 데이터 확인
if ( cesPeekByte ( nSerialChNo, &byData) != ceERR_NONE )
{
OutputDebugString ( "cesPeekByte has been failed" );
}

// 0 번 시리얼 포트에 대해 수신 버퍼의 임의의 위치의 바이트 데이터 확인
if ( cesPeekByteEx ( nSerialChNo, 5, &byData) != ceERR_NONE ) // zero base 로 6 번째 수신 데이터 확인
{
OutputDebugString ( "cesPeekByteEx has been failed" );
}