Camera3_stream_buffer 構造体のリファレンス

このバッファの同期フェンスを取得します。 HAL は、このバッファへの読み取りまたは書き込みを試行する前に、このフェンス fd で待機する必要があります。

このバッファを待機する必要がないことを示すために、フレームワークを -1 に設定できます。

HAL が process_capture_result() を使用してフレームワークに出力バッファを返すときは、acquire_fence を -1 に設定する必要があります。バッファーを埋める際のエラーが原因で HAL がacquire_fence を待機しない場合、process_capture_result() を呼び出すときに、HAL はバッファーの release_fence をフレームワークによって渡されたacquire_fence に設定する必要があります。これにより、フレームワークはバッファを再利用する前にフェンス上で待機できるようになります。

入力バッファの場合、HAL は process_capture_request() 呼び出し中にacquire_fence フィールドを変更してはなりません。

>= CAMERA_DEVICE_API_VERSION_3_2:

HAL が process_capture_result() を使用してフレームワークに入力バッファを返すときは、acquire_fence を -1 に設定する必要があります。エラーが原因で HAL が入力バッファー取得フェンスを待機しない場合、同期フェンスは出力バッファーで処理される方法と同様に処理される必要があります。

ファイルCamera3.hの1800行目の定義。

バッファへのネイティブ ハンドル

ファイルCamera3.hの1764行目の定義。

このバッファのリリース同期フェンス。 HAL は、バッファをフレームワークに返すときにこのフェンスを設定するか、-1 を書き込んでこのバッファを待機する必要がないことを示す必要があります。

出力バッファの場合、 process_capture_result() に渡される out_buffers 配列にフェンスを設定する必要があります。

<= CAMERA_DEVICE_API_VERSION_3_1:

入力バッファの場合、リリース フェンスは process_capture_request() 呼び出しによって設定する必要があります。

>= CAMERA_DEVICE_API_VERSION_3_2:

入力バッファの場合、 process_capture_result() に渡される input_buffer にフェンスを設定する必要があります。

このバッファの release_fence を通知した後は、所有権がフレームワークに完全に返されているため、HAL はそれ以上このバッファにアクセスしようとしてはなりません。

-1 のフェンスが指定された場合、このバッファーの所有権は process_capture_result の呼び出し直後に戻されます。

ファイルCamera3.hの1827行目の定義。

バッファの現在の状態。camera3_buffer_status_t 値の 1 つ。フレームワークは、エラー状態にあるバッファを HAL に渡しません。 HAL によってバッファーを埋めることができなかった場合、process_capture_result() でフレームワークに返されるときに、バッファーのステータスが CAMERA3_BUFFER_STATUS_ERROR に設定されている必要があります。

ファイルCamera3.hの1773行目の定義。

このバッファが関連付けられているストリームのハンドル

ファイルCamera3.hの1759行目の定義。