Video and Vision Processing Suite Intel® FPGA IPユーザーガイド

ID 683329
日付 6/26/2023
Public
ドキュメント目次
1. Video and Vision Processing Suiteについて 2. Video and Vision Processing IPのスタートガイド 3. Video and Vision Processing IPの機能の説明 4. Video and Vision Processing IPインターフェイス 5. Video and Vision Processing IPレジスター 6. Video and Vision Processing IPのソフトウェア・プログラミング・モデル 7. Protocol Converter Intel® FPGA IP 8. 3D LUT Intel® FPGA IP 9. AXI-Stream Broadcaster Intel® FPGA IP 10. Bits per Color Sample Adapter Intel FPGA IP 11. Chroma Key Intel® FPGA IP 12. Chroma Resampler Intel® FPGA IP 13. Clipper Intel® FPGA IP 14. Clocked Video Input Intel® FPGA IP 15. Clocked Video to Full-Raster Converter Intel® FPGA IP 16. Clocked Video Output Intel® FPGA IP 17. Color Space Converter Intel® FPGA IP 18. Deinterlacer Intel® FPGA IP 19. FIR Filter Intel® FPGA IP 20. Frame Cleaner Intel® FPGA IP 21. Full-Raster to Clocked Video Converter Intel® FPGA IP 22. Full-Raster to Streaming Converter Intel® FPGA IP 23. Genlock Controller Intel® FPGA IP 24. Generic Crosspoint Intel® FPGA IP 25. Genlock Signal Router Intel® FPGA IP 26. Guard Bands Intel® FPGA IP 27. Interlacer Intel® FPGA IP 28. Mixer Intel® FPGA IP 29. Parallel Converter Intel® FPGA IPのピクセル 30. Scaler Intel® FPGA IP 31. Stream Cleaner Intel® FPGA IP 32. Switch Intel® FPGA IP 33. Tone Mapping Operator Intel® FPGA IP 34. Test Pattern Generator Intel® FPGA IP 35. Video and Vision Monitor Intel FPGA IP 36. Video Frame Buffer Intel® FPGA IP 37. Video Frame Reader Intel FPGA IP 38. Video Frame Writer Intel FPGA IP 39. Video Streaming FIFO Intel® FPGA IP 40. Video Timing Generator Intel® FPGA IP 41. Warp Intel® FPGA IP 42. デザイン・セキュリティー 43. Video and Vision Processing Suiteユーザーガイドの文書改訂履歴

38.5. Video Frame Writer IPのソフトウェアAPI

IPには、ランタイム時にIPをソフトウェア制御するためのソフトウェア・ドライバーが含まれています。このIPは、Nios II HALが提供する汎用デバイスモデルのいずれにも適合しません。これは、一連の専用アクセサーをコントロール・レジスターおよびステータスレジスターに公開します。ドライバー構造は基本ドライバー構造を継承するため、 Video and Vision Processing IPのソフトウェアAPI で説明されているすべての一般的なメソッドを適用できます。

レジスター定義ヘッダーファイル: intel_vvp_vfw_regs.h

インクルード・ファイル: intel_vvp_vfw.h

表 760.  Video Frame Writer IPのソフトウェアAPI
名前 説明
intel_vvp_vfw_init Frame Writerインスタンスを初期化します。
intel_vvp_core_* Video and Vision Processing IPのソフトウェア・プログラミング・モデル で定義されたアクセサー。Liteがオンの場合に書き込み可能。LiteがオフでDebug featuresがオンの場合には、読み出しが可能です。
intel_vvp_vfw_get_lite_mode Lite modeがオンの場合に返します。
intel_vvp_vfw_get_debug_enabled Debug featuresがオンの場合に返します。
intel_vvp_vfw_get_max_height サポートされている最大の高さを返します。
intel_vvp_vfw_get_max_width サポートされている最大幅を返します。
intel_vvp_vfw_get_bps カラーサンプルごとのビット数を返します。
intel_vvp_vfw_get_number_of_color_planes ピクセルあたりのカラープレーンの数を返します。
intel_vvp_vfw_get_pixels_in_parallel 並列にストリーミングされるピクセルの数を返します。
intel_vvp_vfw_get_mem_word_packing メモリー内のピクセルパッキングに使用されるアルゴリズムを返します。
intel_vvp_vfw_is_running 現在、IPがビデオデータを処理しているかどうかを返します。
intel_vvp_vfw_get_commit_status コミットされていない書き込みがある場合に返します。
intel_vvp_vfw_get_status ステータスレジスターを読み出します。
intel_vvp_vfw_is_buffer_available フィールドがメモリーにバッファリングされているかどうかを返します。
intel_vvp_vfw_get_buffer_write_count メモリーに書き込まれたフィールドの数を返します。
intel_vvp_vfw_get_buffer_start_addr 最後に使用可能になったバッファーのメモリー内のベースアドレスを返します。
intel_vvp_vfw_is_buffer_f1 最後に使用可能になったバッファーのフィールドがF1フィールドであるかどうかを返します。
intel_vvp_vfw_get_buffer_width 最後に使用可能になったバッファーのフィールド幅を返します。
intel_vvp_vfw_get_buffer_height 最後に使用可能になったバッファーのフィールドの高さを返します。
intel_vvp_vfw_get_field_count 最後の画像情報パケットから抽出されたfield_countフィールドを返します (フルバリアントのみ)。
intel_vvp_vfw_acknowledge_buffer 新しく書き込まれたバッファーを確認します。
intel_vvp_vfw_set_run_mode 実行モードを変更します。
intel_vvp_vfw_get_run_mode 実行モードを返します。
intel_vvp_vfw_set_num_buffers 使用中のバッファーの数を設定します。
intel_vvp_vfw_get_num_buffers 使用中のバッファーの数を返します。
intel_vvp_vfw_set_base_addr メモリー内の最初のバッファーのベースアドレスを設定します。
intel_vvp_vfw_get_base_addr メモリー内の最初のバッファーのベースアドレスを返します。
intel_vvp_vfw_set_inter_buffer_offset メモリー内のフィールドバッファー間のオフセットを設定します。
intel_vvp_vfw_get_inter_buffer_offset メモリー内のフィールドバッファー間のオフセットを返します。
intel_vvp_vfw_set_inter_line_offset メモリー内の行間のオフセットを設定します。
intel_vvp_vfw_get_inter_line_offset メモリー内の行間のオフセットを返します。
intel_vvp_vfw_set_irq_line_threshold 割り込みを発生させるために使用されるラインしきい値を選択します。
intel_vvp_vfw_get_irq_line_threshold 割り込みを発生させるために使用されるラインしきい値を返します。
intel_vvp_vfw_overwrite_broken_fields 壊れたフィールドの上書き動作を選択します。
intel_vvp_vfw_get_overwrite_broken_fields 壊れたフィールドが上書きされた場合に返します。
intel_vvp_vfw_commit_writes すべての未処理の書き込みをコミットします。

enum eIntelVvpVfwPacking

メンバー

kIntelVvpVfwPerfectPacking (0) - 完璧なサンプルパッキング (無駄なビットなし)

kIntelVvpVfwColorPacking (1) - カラーサンプルのパッキング (カラーサンプルのメモリーワードへの分割はなし)

kIntelVvpVfwPixelPacking (2) - ピクセルパッキング (ピクセルのメモリーワードへの分割はなし)

kIntelVvpVfwInvalidPacking (-1) - 無効なパッキングのアルゴリズム (エラーを示すために使用)

説明

メモリー・アルゴリズムのコンフィグレーション可能なサンプルパッキングの列挙

enum eIntelVvpVfwRunMode

メンバー

kIntelVvpVfwStop (0) - Frame Writerが停止

kIntelVvpVfwFreeRunning (1) - Frame Writerが使用可能なすべてのバッファーを使用してラウンドロビン方式で処理中

kIntelVvpVfwSingleShot (3) - すべてのバッファーに一度書き込まれると、Frame Writerが進行し、その後停止

kIntelVvpVfwInvalidRunMode (-1) – 無効な値 (エラーを示すために使用)

説明

さまざまな書き込みメソッドの列挙

intel_vvp_vfw_init

プロトタイプ
int intel_vvp_vfw_init(intel_vvp_vfw_instance *instance, intel_vvp_core_base base);
説明

Frame Writerのインスタンスを初期化します。ベースアドレスで読み出されたベンダーIDまたは製品IDが一致しない場合、またはレジスターマップのバージョンがサポートされていない場合、初期化は早期に停止します。それ以外の場合、関数はIPコンパイル時のパラメーター化の読み出しと格納に進みます。インスタンスは完全に初期化されていないため、ゼロ以外のエラーコードを返した場合、アプリケーションはそれ以上使用しないでください。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

ベース - レジスターマップのベースアドレス

戻り値

成功の場合はkIntelVvpCoreOk (0)、エラーの場合は負のエラーコード

コアのベンダーIDがインテルFPGAベンダーID (0x6AF7) ではない場合、kIntelVvpCoreVidErr

product_idがFrame Writer製品IDと一致しない場合、kIntelVvpCorePidErr

インスタンスがヌルポインターの場合は、kIntelVvpCoreInstanceErr

レジスターマップがサポートされていない場合は、kIntelVvpFrameWriterRegMapVersionErr

intel_vvp_vfw_get_lite_mode

プロトタイプ
bool intel_vvp_vfw_get_lite_mode(intel_vvp_vfw_instance *instance);
説明

LITE_MODEレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

IPがライトモードでパラメーター化されている場合は、True

intel_vvp_vfw_get_debug_enabled

プロトタイプ
bool intel_vvp_vfw_get_debug_enabled(intel_vvp_vfw_instance *instance);
説明

DEBUG_ENABLEDレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

デバッグ機能がイネーブルになってIPがパラメーター化されている場合は、Trueを返します。

intel_vvp_vfw_get_max_height

プロトタイプ
uint32_t intel_vvp_vfw_get_max_height(intel_vvp_vfw_instance *instance);
説明

MAX_HEIGHTレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

コンフィグレーション時に設定されたサポートされている最大の高さ

intel_vvp_vfw_get_max_width

プロトタイプ
uint32_t intel_vvp_vfw_get_max_width(intel_vvp_vfw_instance *instance);
説明

MAX_WIDTHレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

コンフィグレーション時に設定されたサポートされている最大の幅

intel_vvp_vfw_get_bps

プロトタイプ
uint8_t intel_vvp_vfw_get_bps(intel_vvp_vfw_instance *instance);
説明

BPSレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

コンフィグレーション時に選択されたカラーサンプルごとのビット数

intel_vvp_vfw_get_number_of_color_planes

プロトタイプ
uint8_t intel_vvp_vfw_get_number_of_color_planes(intel_vvp_vfw_instance *instance);
説明

NUMBER_OF_COLOR_PLANESレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

コンフィグレーション時に選択されたピクセルあたりのカラープレーンの数

intel_vvp_vfw_get_pixels_in_parallel

プロトタイプ
uint8_t intel_vvp_vfw_get_pixels_in_parallel(intel_vvp_vfw_instance *instance);
説明

PIXELS_IN_PARALLELレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

コンフィグレーション時に選択された並行してストリーミングされるピクセルの数

intel_vvp_vfw_get_mem_word_packing

プロトタイプ
eIntelVvpVfwPacking intel_vvp_vfw_get_mem_word_packing(intel_vvp_vfw_instance *instance);
説明

WORD_PACKINGレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

メモリー内のフィールドのピクセルとカラーサンプルをパッキング/アンパッキングするために使用されるアルゴリズム

intel_vvp_vfw_is_running

プロトタイプ
bool intel_vvp_vfw_is_running(intel_vvp_vfw_instance* instance);
説明

STATUSレジスターの実行ビットを読み出して返します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

IPが現在フィールドを読み出している場合はTrue、2つの出力フィールドの間にある場合はFalse

intel_vvp_vfw_get_commit_status

プロトタイプ
bool intel_vvp_vfw_get_commit_status(intel_vvp_vfw_instance* instance);
説明

STATUSレジスターのコミット・ステータス・ビットを読み出して返します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

コミットされていない書き込みがある場合、True

intel_vvp_vfw_get_status

プロトタイプ
uint32_t intel_vvp_vfw_get_status(intel_vvp_vfw_instance* instance);
説明

STATUSレジスターを読み出します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

STATUSレジスターの内容

intel_vvp_vfw_is_buffer_available

プロトタイプ
bool intel_vvp_vfw_is_buffer_available(intel_vvp_vfw_instance* instance);
説明

BUFFER_AVAILABLEレジスターを読み出します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

intel_vvp_vfw_acknowledge_bufferの最後の呼び出し以降に新しいバッファーがメモリーに書き込まれた場合は、True

intel_vvp_vfw_get_buffer_write_count

プロトタイプ
uint32_t intel_vvp_vfw_get_buffer_write_count(intel_vvp_vfw_instance* instance);
説明

BUFFER_WRITE_COUNTレジスターを読み出します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

メモリーに書き込まれても破棄されなかったバッファーの数

intel_vvp_vfw_get_buffer_start_addr

プロトタイプ
uint32_t intel_vvp_vfw_get_buffer_start_addr(intel_vvp_vfw_instance* instance);
説明

BUFFER_START_ADDRESSレジスターを読み出します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

使用可能としてフラグが付けられた最後のフィールドのメモリーアドレス

intel_vvp_vfw_is_buffer_f1

プロトタイプ
bool intel_vvp_vfw_is_buffer_f1(intel_vvp_vfw_instance* instance);
説明

BUFFER_F1_FLAGレジスターを読み出して返します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

使用可能になった最後のバッファーがF1フィールドの場合は、True

intel_vvp_vfw_get_buffer_width

プロトタイプ
uint32_t intel_vvp_vfw_get_buffer_width(intel_vvp_vfw_instance* instance);
説明

BUFFER_WIDTHレジスターを読み出して返します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

使用可能になった最後のバッファーの幅

intel_vvp_vfw_get_buffer_height

プロトタイプ
uint32_t intel_vvp_vfw_get_buffer_height(intel_vvp_vfw_instance* instance);
説明

BUFFER_HEIGHTレジスターを読み出して返します。インスタンスは、完全に初期化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

使用可能になった最後のバッファーの高さ

intel_vvp_vfw_get_field_count

プロトタイプ
uint32_t intel_vvp_vfw_get_field_count(intel_vvp_vfw_instance* instance);
説明

FIELD_COUNTレジスターを読み出して返します。インスタンスは、デバッグがイネーブルになって完全に初期化およびパラメーター化された有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

T

intel_vvp_vfw_acknowledge_buffer

プロトタイプ
int intel_vvp_vfw_acknowledge_buffer(intel_vvp_vfw_instance *instance);
説明

BUFFER_ACKNOWLEDGEレジスターに書き込み、将来のバッファー用のスペースを解放します。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

成功の場合はkIntelVvpCoreOk、失敗の場合は負のエラーコード

インスタンスが無効な場合、kIntelVvpCoreInstanceErr

intel_vvp_vfw_set_run_mode

プロトタイプ
int intel_vvp_vfw_set_run_mode(intel_vvp_vfw_instance *instance, eIntelVvpVfwRunMode run_mode);
説明

RUN_MODEレジスターに新しい値を書き込み、バッファーをメモリーに格納するときに使用する書き込みプロセスを選択します。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

run_mode - 新しいrun_mode

別の実行モードが選択されるまでフレームライターを停止する場合、kIntelVvpVfwStop

ラウンドロビン方式ですべてのバッファーを使用して受信フィールドを格納する場合、kIntelVvpVfwFreeRunning

すべてのバッファーが一度書き込まれるまで受信フィールドを格納する場合、kIntelVvpVfwSingleShot

戻り値

成功の場合はkIntelVvpCoreOk、失敗の場合は負のエラーコード

インスタンスが無効な場合、kIntelVvpCoreInstanceErr

intel_vvp_vfw_get_run_mode

プロトタイプ
eIntelVvpVfwRunMode intel_vvp_vfw_get_run_mode(intel_vvp_vfw_instance* instance);
説明

RUN_MODEレジスターの現在の値を読み出して返します。インスタンスは、完全に初期化され、デバッグをイネーブルするようにコンフィグレーションされた有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

IPがレジスターのリードバックをイネーブルするようにコンフィグレーションされている場合、RUN_MODEレジスターに書き込まれた最後の値

intel_vvp_vfw_set_num_buffers

プロトタイプ
int intel_vvp_vfw_set_num_buffers(intel_vvp_vfw_instance *instance, uint32_t num_buffers);
説明

NUM_BUFFERSレジスターに新しい値を書き込み、バッファーの数を選択します。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

num_buffers - 新しいバッファー数

戻り値

成功の場合はkIntelVvpCoreOk、失敗の場合は負のエラーコード

インスタンスが無効な場合、kIntelVvpCoreInstanceErr

intel_vvp_vfw_get_num_buffers

プロトタイプ
uint32_t intel_vvp_vfw_get_num_buffers(intel_vvp_vfw_instance* instance);
説明

NUM_BUFFERSレジスターの現在の値を読み出して返します。インスタンスは、完全に初期化され、デバッグをイネーブルするようにコンフィグレーションされた有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

IPがレジスターのリードバックをイネーブルするようにコンフィグレーションされている場合、NUM_BUFFERSレジスターに書き込まれた最後の値

intel_vvp_vfw_set_base_addr

プロトタイプ
int intel_vvp_vfw_set_base_addr(intel_vvp_vfw_instance *instance, uint32_t base_addr);
説明

BUFFER_BASEレジスターに新しい値を書き込み、メモリー内のバッファーの新しいベースアドレスを選択します。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

base_addr - 最初のバッファーのベースアドレス

戻り値

成功の場合はkIntelVvpCoreOk、失敗の場合は負のエラーコード

インスタンスが無効な場合、kIntelVvpCoreInstanceErr

intel_vvp_vfw_get_base_addr

プロトタイプ
uint32_t intel_vvp_vfw_get_base_addr(intel_vvp_vfw_instance* instance);
説明

BUFFER_BASEレジスターの現在の値を読み出して返します。インスタンスは、完全に初期化され、デバッグをイネーブルするようにコンフィグレーションされた有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

IPがレジスターのリードバックをイネーブルするようにコンフィグレーションされている場合、BUFFER_BASEレジスターに書き込まれた最後の値

intel_vvp_vfw_set_inter_buffer_offset

プロトタイプ
int intel_vvp_vfw_set_inter_buffer_offset(intel_vvp_vfw_instance *instance, uint32_t inter_buffer_offset);
説明

INTER_BUFFER_OFFSETレジスターに新しい値を書き込み、バッファーの新しいバッファー間オフセットを選択します。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

inter_buffer_offset - 2つのバッファー間のオフセット (バイト単位)、つまり各バッファーに割り当てられたバイト数

戻り値

成功の場合はkIntelVvpCoreOk、失敗の場合は負のエラーコード

インスタンスが無効な場合、kIntelVvpCoreInstanceErr

intel_vvp_vfw_get_inter_buffer_offset

プロトタイプ
uint32_t intel_vvp_vfw_get_inter_buffer_offset(intel_vvp_vfw_instance* instance);
説明

INTER_BUFFER_OFFSETレジスターの現在の値を読み出して返します。インスタンスは、完全に初期化され、デバッグをイネーブルするようにコンフィグレーションされた有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

IPがレジスターのリードバックをイネーブルするようにコンフィグレーションされている場合、INTER_BUFFER_OFFSETレジスターに書き込まれた最後の値

intel_vvp_vfw_set_inter_line_offset

プロトタイプ
int intel_vvp_vfw_set_inter_line_offset(intel_vvp_vfw_instance *instance, uint32_t inter_line_offset);
説明

INTER_LINE_OFFSETレジスターに新しい値を書き込み、バッファーの新しい行間オフセットを選択します。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

inter_line_offset - 連続する行間のオフセット (バイト単位)

戻り値

成功の場合はkIntelVvpCoreOk、失敗の場合は負のエラーコード

インスタンスが無効な場合、kIntelVvpCoreInstanceErr

intel_vvp_vfw_get_inter_line_offset

プロトタイプ
uint32_t intel_vvp_vfw_get_inter_line_offset(intel_vvp_vfw_instance* instance);
説明

INTER_LINE_OFFSETレジスターの現在の値を読み出して返します。インスタンスは、完全に初期化され、デバッグをイネーブルするようにコンフィグレーションされた有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

IPがレジスターのリードバックをイネーブルするようにコンフィグレーションされている場合、INTER_LINE_OFFSETレジスターに書き込まれた最後の値

intel_vvp_vfw_set_irq_line_threshold

プロトタイプ
int intel_vvp_vfw_set_irq_line_threshold(intel_vvp_vfw_instance *instance, uint32_t line_threshold);
説明

IRQ_LINE_THRESHOLDレジスターに新しい値を書き込み、割り込みを発生させる新しいしきい値を選択します。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

line_threshold - 新しい行のしきい値

戻り値

成功の場合はkIntelVvpCoreOk、失敗の場合は負のエラーコード

インスタンスが無効な場合、kIntelVvpCoreInstanceErr

intel_vvp_vfw_get_irq_line_threshold

プロトタイプ
uint32_t intel_vvp_vfw_get_irq_line_threshold(intel_vvp_vfw_instance* instance);
説明

IRQ_LINE_THRESHOLDレジスターの現在の値を読み出して返します。インスタンスは、完全に初期化され、デバッグをイネーブルするようにコンフィグレーションされた有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

IPがレジスターのリードバックをイネーブルするようにコンフィグレーションされている場合、選択したバッファーセットのIRQ_LINE_THRESHOLDレジスターに書き込まれた最後の値

intel_vvp_vfw_overwrite_broken_fields

プロトタイプ
int intel_vvp_vfw_overwrite_broken_fields(intel_vvp_vfw_instance *instance, bool overwrite_broken);
説明

OVERWRITE_BROKENレジスターに新しい値を書き込み、フレームライターが壊れたフィールドを処理する方法を選択します。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

overwrite_broken - 壊れたフィールドを無視して上書きする場合はTrue、そうでない場合はFalse

戻り値

成功の場合はkIntelVvpCoreOk、失敗の場合は負のエラーコード

インスタンスが無効な場合、kIntelVvpCoreInstanceErr

intel_vvp_vfw_get_overwrite_broken_fields

プロトタイプ
bool intel_vvp_vfw_get_overwrite_broken_fields(intel_vvp_vfw_instance* instance);
説明

OVERWRITE_BROKENレジスターの現在の値を読み出して返します。インスタンスは、完全に初期化され、デバッグをイネーブルするようにコンフィグレーションされた有効なintel_vvp_vfw_instanceである必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

IPがレジスターのリードバックをイネーブルするようにコンフィグレーションされている場合、OVERWRITE_BROKENレジスターに書き込まれた最後の値

intel_vvp_vfw_commit_writes

プロトタイプ
int intel_vvp_vfw_commit_writes(intel_vvp_vfw_instance* instance)
説明

次のフィールドを処理する前に、ペンディング中の書き込みをすべてコミットします。インスタンスは有効である必要があります。

引数

インスタンス - intel_vvp_vfw_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

成功の場合はkIntelVvpCoreOk (0)、それ以外の場合は負のエラーコード