IC4_PROPERTY 構造体リファレンス

コンポーネント（通常はビデオキャプチャデバイス）のプロパティを表します。

すべてのプロパティの型は IC4_PROPERTY へのポインタで参照され、プロパティの型ごとの専用型はありません。

IC4_PROPERTY は列挙エントリも表します。列挙エントリは実際にはカテゴリツリーに含まれるプロパティではありませんが、すべての標準的なプロパティ操作をサポートします。

プロパティオブジェクトは複数の方法で作成されます:

• ic4_propmap_find() または ic4_propmap_find_integer() のような型付きの同類関数を呼び出す。
• 以前に取得したPropertyListからプロパティを取り出すために ic4_proplist_at() を呼び出す。PropertyListは次の方法で取得します:
  • カテゴリからすべてのプロパティを取得するために ic4_prop_category_get_features() を呼び出す。
  • 列挙プロパティの列挙エントリを取得するために ic4_prop_enum_get_entries() を呼び出す。
  • あるプロパティによって選択されているプロパティを取得するために ic4_prop_get_selected_props() を呼び出す。
  • PropertyMapのカテゴリツリー内のすべてのプロパティを取得するために ic4_propmap_get_all() を呼び出す。

これらいずれかの方法で取得され、同じデバイスプロパティを参照するプロパティオブジェクトは、常に同じポインタ値を持ちます。

特定のプロパティ型を期待する関数を、それと異なる型のプロパティに対して呼び出すと失敗し、エラー値は IC4_ERROR_GENICAM_TYPE_MISMATCH に設定されます。