---
title: "4.2. 플랫폼이 제공하는 API"
---

다음은 실제로 플랫폼이 해당 API 를 구현하여, HAL 또는 타 태스크에서 사용하는 함수들이다. 주로, 타 태스크에서 플랫폼 태스크로 이벤트를 전달 하거나, 플랫폼을 시작하기 위해서 필요하다. **HAL 포팅시 구현해야 할 API 가 아니며 제공하는 플랫폼 라이브러리에 포함되어 있어야 한다.**


### MH_pltEvent

**설명**

타 태스크에서 플랫폼으로 이벤트를 넘겨 줄 때 사용하는 함수이다. 함수를 호출 할 때 함께 넘겨줄 이벤트에 대한 세부 정보는 하단 표의 매개변수 필드를 참조하면 된다.

| 이벤트 | 매개변수 |
|---|---|
| `MH_KEY_PRESSEVENT`, `MH_KEY_RELEASEEVENT`, `MH_KEY_REPEATEVENT` | `MH_KeyCode` |
| `MH_EXIT_EVENT` | `NULL` |
| `MH_TIMER_EVENT` | `NULL` |
| `MH_SMS_EVENT` | `MH_SMSEvent`의 포인터 |
| `MH_ANN_EVENT` | `MH_AnnInfo`의 포인터 |
| `MH_CALL_EVENT` | `MH_CallEvent`의 포인터 |
| `MH_NETWORK_EVENT` | `MH_NetEvent`의 포인터 |
| `MH_SERIAL_EVENT` | `MH_SerialEvent`의 포인터 |
| `MH_MEDIA_EVENT` | `MH_MediaEvent`의 포인터 |

표 1 HAL에서 전달 받는 이벤트에 대한 매개 변수

- `MH_KEY_PRESSEVENT` - 단말기 버튼이 눌렸을 때 해당 버튼의 KeyCode 값을 MH_KeyCode 에 정의된 키로 변경시킨 후 이 함수를 통해서 전달해야 한다.
- `MH_KEY_RELEASEEVENT` - 단말기 버튼이 떼어졌을 때 해당 버튼의 KeyCode 값을 MH_KeyCode 에 정의된 키로 변경시킨 후 이 함수를 통해서 전달한다.
- `MH_KEY_REPEATEVENT` - 단말기 버튼이 일정시간이상 눌려져 있으면, 일정시간이후 부터 주기적으로 `MH_KEYREPEAT_EVENT` 를 단발기 버튼이 떼어질때까지 플랫폼에 보낼 수 있다. 운영체제가 `MH_KEYREPEAT_EVENT` 를 지원하면 `MH_sysGetInformation()`에서 key repeat 첫 발생시간과, 발생주기시간를 반환해야 한다.
- `MH_EXIT_EVENT` - 표준 플랫폼의 수행을 종료할 때 전달한다.
- `MH_TIMER_EVENT` - MH_timerSet()에 의해 설정된 타이머가 만료될 때 전달한다.
- `MH_SMS_EVENT` – 새로운 SMS 메시지가 도착할 때 전달한다.
- `MH_ANN_EVENT` - 어넌시에이터(Annunciator)의 정보가 갱신되는 경우 전달한다.
- `MH_CALL_EVENT` – 전화가 왔을 때 전달한다.
- `MH_NETWORK_EVENT` – 네트워크 이벤트를 전달한다.
- `MH_SERIAL_EVENT` – 시리얼 이벤트를 전달한다.
- `MH_MEDIA_EVENT` – 사운드 이벤트를 전달한다.

**프로토타입**

```c
M_Boolean MH_pltEvent(MH_Event event, void *param)
```

**매개 변수**

- `event` - [in] 표준 플랫폼에게 넘겨주는 event
- `param` - [in] 해당 event 에 대한 세부 정보값. 표의 매개변수 필드 참조.

**반환 값**

성공

- `TRUE`

실패

- `FALSE` – 지원하지 않는 이벤트이거나, 이벤트를 수신하는 큐가 full이다.

**부작용**

`MH_EXIT_EVENT` 이벤트가 전달되면 `MH_pltStart()`함수를 반환하고 플랫폼은 종료된다.

**참고 항목**

없음

### MH_pltStart

**설명**

HAL 에서 플랫폼을 시작하기 위한 함수이다. 이 함수가 불려 지면 플랫폼이 수행 되고, `MH_EXIT_EVENT` 이벤트를 받기 전 까지는 반환 되지 않는다. 매개변수는 플 랫폼 최초 수행시 수행시킬 프로그램을 지정한다.

예) 애플리케이션 매니저가 자바로 구현되고, Main class 이름이 `org.kwis.am.Main` 이며 폰이미지에 같이 있을 경우,

```c
MH_pltStart(0, “org.kwis.am.Main”, 0, 0);
```

예) 애플리케이션 매니저가 자바로 구현되고, Main class 이름이 `org.kwis.am.Main`이며 `/test/appManager.jar` 라는 독립된 파일로 존재할 경우,

```c
MH_pltStart(0, “org.kwis.am.Main”, “/test/appManager.jar”, 0);
```

**프로토타입**

```c
M_Int32 MH_pltStart(M_Int32 JavaC, M_Char* programID, M_Char* path, M_Char* args)
```

**매개 변수**

- `JavaC` - [in]  0 이면 Java, 1 이면 C 프로그램
- `programID` - [in]  java 인 경우, 수행시킬 프로그램의 main class 이름을 가리킨다. C 인 경우, 수행시킬 프로그램을 지정할 수 있는 ID
- `path` - [in] path 값은 수행시킬 프로그램의 독립된 file 을 가리킨다. null 이면 수행시킬 프로그램이 폰이미지안에 같이 포함되어 있는 것을 의미한다.
- `args` - [in] 실행시킬 프로그램에 전달할 매개변수(전달할 매개변수가 없으면 0)

**반환 값**

음수면 비정상 종료임.

**부작용**

없음

**참고 항목**

없음