目次目次... 1 はじめに... 3 概要... 4 サポート環境... 5 関数... 6 MEC_OpenDevice... 7 MECDevice_Release... 8 MECDevice_GetFirmVersion... 9 MECDevice_GetCoreTemperature

Size: px

Start display at page:

Download "目次目次... 1 はじめに... 3 概要... 4 サポート環境... 5 関数... 6 MEC_OpenDevice... 7 MECDevice_Release... 8 MECDevice_GetFirmVersion... 9 MECDevice_GetCoreTemperature"

やすもりすみだ
5 years ago
Views:

1 MECodecAPI Reference Manual 2015 年 9 月 1 日 MEDIAEDGE 株式会社

2 目次目次... 1 はじめに... 3 概要... 4 サポート環境... 5 関数... 6 MEC_OpenDevice... 7 MECDevice_Release... 8 MECDevice_GetFirmVersion... 9 MECDevice_GetCoreTemperature MECDevice_GetHDMIOutput MECDevice_SetHDMIOutput MECDevice_GetSPDIFOutput MECDevice_SetSPDIFOutput MECDevice_CreateDecoder MECDecoder_Release MECDecoder_Start MECDecoder_Stop MECDecoder_Pause MECDecoder_SendStream MECDecoder_GetState MECDecoder_GetElapseTime MECDecoder_GetParam MECDecoder_SetParam MECDecoder_GetEventCallback MECDecoder_SetEventCallback 構造体 MEC_HDMI_OUTPUT MEC_SPDIF_OUTPUT MEC_RESOLUTION MEC_FRACTION MEC_BUFFER MEC_VIDEO_PARAM MEC_AUDIO_PARAM MEC_EXT_TS_PARAM MEC_EXT_ES_PARAM MEC_STREAM_PARAM

3 MEC_PACKET MEC_EVENT_CALLBACK 列挙値 MEC_ERROR MEC_VIDEO_FORMAT MEC_CODEC_ID MEC_STREAM_TYPE MEC_STATE MEC_EVENT

4 はじめに 3

5 概要本 SDK は ME-DEC5000HDMI を使用したアプリケーションの開発を目的としたプログラムです SDK で利用できる機能は以下の通りです対応ビデオコーデックは H265/HEVC H264/AVC 対応オーディオコーデックは AAC トランスポートストリーム形式での入力エレメンタリーストリーム形式での入力 ( 注 : MP4 から抽出したストリームのみ対応 ) 4

6 サポート環境 SDK がサポートする環境は以下の通りです OS Windows 7 (64bit) Windows 8.1 (64bit) 開発環境 Visual Studio 2013 MECodecAPI に関しては Visual Studio 2013 Express でもお使いいただけますが付属のサンプルプログラムをビルドするには Professional 以上のバージョンが必要ですまた本 SDK で提供されるライブラリは全て 64bit でビルドしたものです 32bit 版 DLL は含んでおりません開発の際は必ずプロジェクト構成のプラットフォームを x64 にしてください開発したアプリケーションを実行する際は以下のファイルを同じフォルダに置いてください MECodecAPI.dll PCIePXsCOM.dll PCIePXsEx.dll また上記のファイルに加えて Visual Studio 2013 のランタイムライブラリが必要です 5

7 関数 6

8 MEC_OpenDevice デバイスに接続します MEC_ERROR MEC_EXPORT MEC_OpenDevice( ULONG deviceid, MEC_DEVICE *pdevice ); 引数 [in] deviceid 0 から始まるデバイス ID [out] pdevice デバイスオブジェクトへのポインター 7

9 MECDevice_Release デバイスオブジェクトを解放しデバイスとの接続を閉じます MEC_ERROR MEC_EXPORT MECDevice_Release( MEC_DEVICE device ); 引数 [in]device デバイスオブジェクト 8

10 MECDevice_GetFirmVersion ファームのバージョン情報を取得します MEC_ERROR MEC_EXPORT MECDevice_GetFirmVersion( MEC_DEVICE device, ULONG *pvalue ); 引数 [in] device デバイスオブジェクト [out] pvalue バージョン情報へのポインタ 9

11 MECDevice_GetCoreTemperature デバイスのコア温度を取得します MEC_ERROR MEC_EXPORT MECDevice_GetCoreTemperature( MEC_DEVICE device, INT *pvalue ); 引数 [in] device デバイスオブジェクト [out] pvalue 温度値へのポインタ 10

12 MECDevice_GetHDMIOutput HDMI 出力の設定を取得します MEC_ERROR MEC_EXPORT MECDevice_GetHDMIOutput( MEC_DEVICE device, MEC_HDMI_OUTPUT *pvalue ); 引数 [in] device デバイスオブジェクト [out] pvalue HDMI 出力の設定値へのポインタ 11

13 MECDevice_SetHDMIOutput HDMI 出力を設定します MEC_ERROR MEC_EXPORT MECDevice_SetHDMIOutput( MEC_DEVICE device, const MEC_HDMI_OUTPUT *pvalue ); 引数 [in] device デバイスオブジェクト [in] pvalue HDMI 出力の設定値へのポインタ 12

14 MECDevice_GetSPDIFOutput SPDIF 出力の設定を取得します MEC_ERROR MEC_EXPORT MECDevice_GetSPDIFOutput( MEC_DEVICE device, MEC_SPDIF_OUTPUT *pvalue ); 引数 [in] device デバイスオブジェクト [out] pvalue SPDIF 出力の設定値へのポインタ 13

15 MECDevice_SetSPDIFOutput SPDIF 出力を設定します MEC_ERROR MEC_EXPORT MECDevice_SetSPDIFOutput( MEC_DEVICE device, const MEC_SPDIF_OUTPUT *pvalue ); 引数 [in] device デバイスオブジェクト [in] pvalue SPDIF 出力の設定値へのポインタ 14

16 MECDevice_CreateDecoder デコーダーオブジェクトを作成します MEC_ERROR MEC_EXPORT MECDevice_CreateDecoder( MEC_DEVICE device, MEC_DECODER *pdecoder ); 引数 [in] device デバイスオブジェクト [out] pdecoder デコーダーオブジェクトへのポインタ 15

17 MECDecoder_Release デコーダーオブジェクトを破棄します MEC_ERROR MEC_EXPORT MECDecoder_Release( MEC_DECODER decoder ); 引数 [in] decoder デコーダーオブジェクト 16

18 MECDecoder_Start デコードを開始します MEC_ERROR MEC_EXPORT MECDecoder_Start( MEC_DECODER decoder ); 引数 [in] decoder デコーダーオブジェクト補足状態が MEC_STATE_READY もしくは MEC_STATE_PAUSED でないと再生は開始されません状態が MEC_STATE_STOPPED の場合は一度 MECDecoder_SetParam 関数でデコードパラメーターを設定してから実行してください 17

19 MECDecoder_Stop デコードを停止します MEC_ERROR MEC_EXPORT MECDecoder_Stop( MEC_DECODER decoder ); 引数 [in] decoder デコーダーオブジェクト補足デコードを停止すると MECDecoder_GetElapseTime で取得できる時間は 0 に戻ります 18

20 MECDecoder_Pause デコードを一時停止します MEC_ERROR MEC_EXPORT MECDecoder_Pause( MEC_DECODER decoder ); 引数 [in] decoder デコーダーオブジェクト補足デコードを再開するには MECDecoder_Start 関数を実行します 19

21 MECDecoder_SendStream デコーダーオブジェクトにデコードさせるデータを入力します MEC_ERROR MEC_EXPORT MECDecoder_SendStream( MEC_DECODER decoder, const MEC_PACKET *ppacket ); 引数 [in] decoder デコーダーオブジェクト [in] ppacket デコードさせるデータ補足トランスポートストリーム形式でデコードさせる場合は ppacket の PID と Time の値は無視されますトランスポートストリーム形式の場合一度に入力するデータのサイズが小さすぎると処理効率が低下してしまい再生が遅延する可能性があります Ver1.0 時点でもっとも効率が良い入力サイズはバイトですエレメンタリーストリーム形式に関しては特に上記のような制限はありません引数の ppacket に NULL を指定するとデコーダーにストリームの終端 (EOS) を入力しますデコーダーは EOS が入力された時点までのデータを出力した後状態を一旦リセットしますこの関数はデコーダーへの入力バッファが満杯になるとバッファに空きができるまで処理をブロックしますブロックされた処理を中断しこの関数から抜けたい場合は別スレッドより MECDecoder_Stop 関数を実行してください 20

22 MECDecoder_GetState デコーダーオブジェクトの状態を取得します MEC_ERROR MEC_EXPORT MECDecoder_GetState( MEC_DECODER decoder, MEC_STATE *pstate ); 引数 [in] decoder デコーダーオブジェクト [out] pstate 状態を示す値へのポインタ 21

23 MECDecoder_GetElapseTime デコードを開始してからの経過時間を取得します MEC_ERROR MEC_EXPORT MECDecoder_GetElapseTime( MEC_DECODER decoder, LONGLONG *pmsec ); 引数 [in] decoder デコーダーオブジェクト [out] pmsec 経過時間を示す値へのポインタ単位はミリ秒です補足 MECDecoder_Stop 関数を実行するもしくは MECDecoder_SendStream 関数で EOS を入力する (ppacket を NULL にする ) と 0 にリセットされます 22

24 MECDecoder_GetParam 現在のデコードパラメーターを取得します MEC_ERROR MEC_EXPORT MECDecoder_GetParam( MEC_DECODER decoder, MEC_STREAM_PARAM *pparam ); 引数 [in] decoder デコーダーオブジェクト [out] pparam デコードパラメーターを示す値へのポインタ 23

25 MECDecoder_SetParam デコードパラメーターを設定します MEC_ERROR MEC_EXPORT MECDecoder_SetParam( MEC_DECODER decoder, const MEC_STREAM_PARAM *pparam ); 引数 [in] decoder デコーダーオブジェクト [in] pparam デコードパラメーターを示す値へのポインタ補足状態が MEC_STATE_STOPPED の時に実行するとパラメーターは即時にデバイスに反映され MEC_STATE_READY に状態遷移しますそれ以外の状態 (MEC_STATE_UNKNOWN は除く ) の時に実行すると渡されたパラメーターは予約として扱われ状態が MEC_STATE_EOS になったときに反映されます予約されたパラメーターが反映されると MEC_EVENT_UPDATE_PARAM というイベントをコールバックしますすでにパラメーターが予約されている場合この関数はエラーを返します ( 予約の多重登録や上書きはできません ) 一度 MECDecoder_Stop 関数を実行して状態を MEC_STATE_STOPPED にするか予約されたパラメーターがデバイスに反映されるのを待ってから実行してください 24

26 MECDecoder_GetEventCallback 現在のイベントに関するコールバックの設定を取得します MEC_ERROR MEC_EXPORT MECDecoder_GetEventCallback( MEC_DECODER decoder, MEC_EVENT_CALLBACK *pcallback ); 引数 [in] decoder デコーダーオブジェクト [out] pcallback コーダーバックの設定を示す値へのポインタ 25

27 MECDecoder_SetEventCallback インベントに関するコールバックを設定します MEC_ERROR MEC_EXPORT MECDecoder_SetEventCallback( MEC_DECODER decoder, const MEC_EVENT_CALLBACK *pcallback ); 引数 [in] decoder デコーダーオブジェクト [in] pcallback コールバックの設定を示す値へのポインタ 26

28 構造体 27

29 MEC_HDMI_OUTPUT デバイスの HDMI 出力の設定です typedef struct { struct { ULONG Format; ULONG RefreshRate } Video; struct { BOOL Valid; } Audio; } MEC_HDMI_OUTPUT; 要素 Video.Format HDMI 出力のビデオ形式 Audio.Valid; HDMI 出力の音声の有無補足音声に関して HDMI 出力と SPDIF 出力は排他仕様です 28

30 MEC_SPDIF_OUTPUT デバイスの SPDIF 出力の設定です typedef struct { struct { BOOL Valid; } Audio; } MEC_SPDIF_OUTPUT; 要素 Audio.Valid SPDIF 出力のオーディオの有無補足音声に関して HDMI 出力と SPDIF 出力は排他仕様です 29

31 MEC_RESOLUTION 解像度を示す値です typedef struct { LONG Width; LONG Height; } MEC_RESOLUTION; 要素 Width 幅単位はピクセルです Height 高さ単位はピクセルです 30

32 MEC_FRACTION 分数を示す値です typedef struct { LONG Num; LONG Den; } MEC_FRACTION; 要素 Num 分子 Den 分母 31

33 MEC_BUFFER バイナリーデータを示す値です typedef struct { BYTE *Ptr; ULONG Size; } MEC_BUFFER; 要素 Ptr バイナリーデータへのポインタ Size バイナリーデータのサイズ 32

34 MEC_VIDEO_PARAM ビデオに関する設定値です typedef struct { ULONG PID; ULONG Codec; MEC_RESOLUTION Resolution; MEC_FRACTION FrameRate; MEC_FRACTION TimeBase; } MEC_VIDEO_PARAM; 要素 PID ビデオを識別するための PID Codec ビデオのコーデック MEC_CODEC_ID を指定します Resolution 解像度 FrameRate フレームレート TimeBase 単位時間 33

35 MEC_AUDIO_PARAM オーディオに関する設定値です typedef struct { ULONG PID; ULONG Codec; ULONG BitsPerSample; ULONG Channels; ULONG SamplingRate; MEC_FRACTION TimeBase; } MEC_AUDIO_PARAM; 要素 PID オーディオを識別するための PID Codec オーディオのコーデック MEC_CODEC_ID を指定します BitsPerSample 1 サンプルあたりのビット数 Channels チャンネル数 SamplingRate サンプリングレート TimeBase 単位時間 34

36 MEC_EXT_TS_PARAM トランスポートストリームをデコードする際の設定値です typedef struct { ULONG PacketSize; } MEC_EXT_TS_PARAM; 要素 PacketSize TS パケットのサイズ 35

37 MEC_EXT_ES_PARAM エレメンタリーストリームをデコードする際の設定値です typedef struct { MEC_BUFFER ExtraData; } MEC_EXT_ES_PARAM; 要素 ExtraData SPS や PPS といったパラメーターを含んだバイナリーデータ 36

38 MEC_STREAM_PARAM デコードに関する設定値です typedef struct { ULONG StreamType; MEC_VIDEO_PARAM Video; MEC_AUDIO_PARAM Audio; union { MEC_EXT_TS_PARAM TS; MEC_EXT_ES_PARAM ES; }; } MEC_STREAM_PARAM; 要素 StreamType ストリーム形式 Video ビデオに関する設定値 Audio オーディオに関する設定値 TS トランスポートストリームに関する設定値 ES エレメンタリーストリームに関する設定値 37

39 MEC_PACKET デコーダーに入力するデータ typedef struct { ULONG PID; LONGLONG Time; MEC_BUFFER Data; } MEC_PACKET; 要素 PID データが属するストリームを識別するための PID Time データの開始時間ここで指定する時間の単位は MEC_VIDEO_PARAM や MEC_AUDIO_PARAM の TimeBase で指定した値です Data デコードさせるデータ 38

40 MEC_EVENT_CALLBACK イベントコールバックに関する設定値です typedef struct { void (*Function)(ULONG, void*); void *UserData; } MEC_EVENT_CALLBACK; 要素 Function コールバック時に呼び出される関数 UserData コールバック時に渡されるユーザー変数 39

41 列挙値 40

42 MEC_ERROR エラーコードです要素 MEC_ERROR_SUCCEDED 成功 MEC_ERROR_FAILED 失敗 MEC_ERROR_DEVICE デバイスエラー MEC_ERROR_DRIVER ドライバーエラー MEC_ERROR_INVALID_VALUE 無効な引数によるエラー MEC_ERROR_TIMEOUT タイムアウトによるエラー MEC_ERROR_STATE 状態遷移によるエラー MEC_ERROR_UNEXCEPT 不明なエラー 41

43 MEC_VIDEO_FORMAT HDMI 出力のビデオ形式です要素 MEC_VIDEO_FORMAT_UNKNOWN 不明な形式 MEC_VIDEO_FORMAT_AUTO 自動選択 MEC_VIDEO_FORMAT_RGB RGB(4K) 形式 MEC_VIDEO_FORMAT_YUV420 YUV420(8bit) 形式. MEC_VIDEO_FORMAT_YUV420_10 YUV420(10bit) 形式 MEC_VIDEO_FORMAT_YUV422 YUV422 形式現在未サポート MEC\VIDEO_FORMAT_RGB_FHD RGB(2K) 形式 42

44 MEC_REFRESH_RATE HDMI 出力のリフレッシュレートです要素 MEC_REFRESH_RATE_UNKNOWN 不明なレート MEC_REFRESH_RATE_AUTO 自動選択 MEC_REFRESH_RATE_23_ Hz 現在未サポート MEC_REFRESH_RATE_24 24Hz 現在未サポート MEC_REFRESH_RATE_25 25Hz 現在未サポート MEC_REFRESH_RATE_29_ Hz 現在未サポート MEC_REFRESH_RATE_30 30Hz 現在未サポート MEC_REFRESH_RATE_50 50Hz MEC_REFRESH_RATE_59_ Hz MEC_REFRESH_RATE_60 60Hz 43

45 MEC_CODEC_ID コーデックを示す ID です要素 MEC_CODEC_ID_UNKNOWN 不明なコーデック MEC_CODEC_ID_NONE ビデオもしくは音声なし MEC_CODEC_ID_H264 H.264/AVC MEC_CODEC_ID_H265 H.265/HEVC MEC_CODEC_ID_AAC AAC 44

46 MEC_STREAM_TYPE ストリーム形式です要素 MEC_STREAM_TYPE_UNKNOWN 不明な形式 MEC_STREAM_TYPE_TS トランスポートストリーム形式 MEC_STREAM_TYPE_ES エレメンタリーストリーム形式 45

47 MEC_STATE デコーダーの状態です要素 MEC_STATE_UNKNOWN 不明な状態 MEC_STATE_STOPPED 停止中 MEC_STATE_EOS 映像終端に到達 ( 停止 ) MEC_STATE_READY 再生準備完了 MEC_STATE_PAUSED 一時停止中 MEC_STATE_STARTED 再生中 46

48 MEC_EVENT デコーダーから通知されるイベント値です要素 MEC_EVENT_UNKNOWN 不明なイベント MEC_EVENT_START デコードを開始しました MEC_EVENT_PAUSE デコードを一時停止しました MEC_EVENT_STOP デコードを停止しました MEC_EVENT_END_OF_STREAM ストリームの終端に到達しました MEC_EVENT_UPDATE_PARAM 予約していたデコードパラメーターがデバイスに反映されました MEC_EVENT_DECODE_ERROR デバイス内でエラーが発生しました 47

<4D F736F F D20B6BCB5D7B2CCDED7D8CFC6ADB1D9315F43532E444F43>

<4D F736F F D20B6BCB5D7B2CCDED7D8CFC6ADB1D9315F43532E444F43> CASSIOPEIA DT-10 ライブラリマニュアル for C# Bluetooth 編 Ver 1.00 変更履歴 No Revision 更新日項改訂内容 1 1.00 05/2/22 初版初版発行 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 目次 1. 概要...1 2. 動作環境...1 3. 開発環境...1

目次 目次... 1 はじめに... 3 概要... 4 サポート環境... 5 関数... 6 MEC_OpenDevice... 7 MECDevice_Release... 8 MECDevice_GetFirmVersion... 9 MECDevice_GetCoreTemperature

目次目次... 1 はじめに... 3 概要... 4 サポート環境... 5 関数... 6 MEC_OpenDevice... 7 MECDevice_Release... 8 MECDevice_GetFirmVersion... 9 MECDevice_GetCoreTemperature