cemStGetMstString

SYNOPSIS

VT_I4 cemStGetMstString(
  VT_I4 MstCode,
  VT_PSTR Buffer,
  VT_I4 BufferLen
)

DESCRIPTION

  • 현재 모션 동작 상태와 관련된 문자열을 반환합니다.

  • ceSDK 의 모션 동작 상태를 확인 하는 cemStReadMotionState 함수를 통해 반환된 모션 동작 상태 값을 매개변수로 전달하게 되면, 해당 상태에 대한 이미 내정된 문자열을 지정된 문자열 주소에 복사합니다.

  • 이 문자열은 라이브러리 내부에서 이미 결정된 문자열 이므로, 사용자 정의 에러 메시지와는 무관합니다.

PARAMETER

  • MstCode : 모션 동작 상태와 관련된 값입니다. cemStReadMotionState 함수를 통해 지정된 상태. 값을 알아볼 수 있으며, 해당 상태 값을 이 함수의 매개변수로 활용할 수 있습니다.

  • Buffer : 모션 동작 상태와 관련된 문자열을 복사해 올 문자열 버퍼의 주소입니다.

  • BufferLen : 모션 동작 상태를 확인하기 위해 전달된 문자열 버퍼의 길이입니다. 이 길이가 실제. 복사될 모션 동작 상태보다 작으면, 실제 전달된 문자열 버퍼의 길이만큼 상태에 대한 문자열을 복사합니다.

RETURN VALUE

Value

Meaning

음수

수행 실패

0 (ceERR_NONE)

수행 성공

Example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
 C/C++
 #include “ceSDK.h”
 #include “ceSDKDef.h”
void OnGetMstString ()
{
char szBuffer[32] = {0, };
// 현재 Motion State 를 Buffer 에 문자열로 저장합니다.
 if ( cemStGetMstString ( cemX1, szBuffer, 32 ) == ceERR_NONE )
 {
 //DisplayMstString() 함수는 화면에 문자를 표시하는 가상의 함수입니다.
 DisplayMstString( szBuffer );
 }
}