Vietnamese (machine translation)

Lưu ý

Mục đích của file này là để độc giả tiếng Việt có thể đọc và hiểu tài liệu nhân kernel dễ dàng hơn, không phải để tạo ra một nhánh tài liệu riêng. Nếu bạn có bất kỳ nhận xét hoặc cập nhật nào cho file này, vui lòng thử cập nhật file tiếng Anh gốc trước. Nếu bạn thấy có sự khác biệt giữa bản dịch và bản gốc, hoặc có vấn đề về bản dịch, vui lòng gửi góp ý hoặc patch cho người dịch của file này, hoặc nhờ người bảo trì và người review tài liệu tiếng Việt giúp đỡ.

Bản gốc:

ioctl VIDIOC_ENUM_FRAMEINTERVALS

Người dịch:

Google Translate (machine translation)

Phiên bản gốc:

8541d8f725c6

Cảnh báo

Tài liệu này được dịch tự động bằng máy và chưa được review bởi người dịch. Nội dung có thể không chính xác hoặc khó hiểu ở một số chỗ. Khi có sự khác biệt với bản gốc, bản gốc luôn là chuẩn. Bản dịch chất lượng cao (được review) được đặt trong thư mục vi_VN/.

7.16. ioctl VIDIOC_ENUM_FRAMEINTERVALS

7.16.1. Tên

VIDIOC_ENUM_FRAMEINTERVALS - Liệt kê các khoảng khung

7.16.2. Tóm tắt

VIDIOC_ENUM_FRAMEINTERVALS

ZZ0000ZZ

7.16.3. Đối số

ZZ0001ZZ

Bộ mô tả tệp được trả về bởi ZZ0000ZZ.

ZZ0001ZZ

Con trỏ tới cấu trúc ZZ0000ZZ chứa định dạng và kích thước pixel và nhận được khoảng thời gian khung.

7.16.4. Sự miêu tả

Ioctl này cho phép các ứng dụng liệt kê tất cả các khoảng thời gian khung mà thiết bị hỗ trợ định dạng pixel và kích thước khung hình nhất định.

Bạn có thể lấy được các định dạng pixel và kích thước khung hình được hỗ trợ bằng cách sử dụng ZZ0000ZZ và Chức năng ZZ0001ZZ.

Giá trị trả về và nội dung của trường ZZ0000ZZ phụ thuộc vào loại khoảng thời gian khung hình mà thiết bị hỗ trợ. Đây là ngữ nghĩa của hàm cho các trường hợp khác nhau:

  • ZZ0004ZZ Hàm trả về thành công nếu giá trị chỉ số đã cho

    (dựa trên số 0) là hợp lệ. Ứng dụng sẽ tăng chỉ số lên một cho mỗi cuộc gọi cho đến khi ZZ0000ZZ được trả về. các Trường ZZ0001ZZ được đặt thành ZZ0002ZZ của người lái xe. Chỉ của công đoàn thành viên ZZ0003ZZ là hợp lệ.

  • ZZ0004ZZ Hàm trả về thành công nếu giá trị chỉ số đã cho

    bằng 0 và ZZ0000ZZ cho bất kỳ giá trị chỉ mục nào khác. các Trường ZZ0001ZZ được đặt thành ZZ0002ZZ của người lái xe. Trong công đoàn chỉ có Thành viên ZZ0003ZZ là hợp lệ.

  • ZZ0005ZZ Đây là trường hợp đặc biệt của loại step-wise ở trên.

    Hàm trả về thành công nếu giá trị chỉ mục đã cho bằng 0 và ZZ0000ZZ cho bất kỳ giá trị chỉ mục nào khác. ZZ0001ZZ trường được trình điều khiển đặt thành ZZ0002ZZ. của liên minh chỉ có thành viên ZZ0003ZZ là hợp lệ và ZZ0004ZZ giá trị được đặt thành 1.

Khi ứng dụng gọi hàm có chỉ số 0, nó phải kiểm tra trường ZZ0000ZZ để xác định loại liệt kê khoảng thời gian khung thiết bị hỗ trợ. Chỉ dành cho loại ZZ0001ZZ việc tăng giá trị chỉ mục để nhận được nhiều khung hình hơn có hợp lý không khoảng thời gian.

Lưu ý

The order in which the frame intervals are returned has no special meaning. In particular does it not say anything about potential default frame intervals.

Các ứng dụng có thể cho rằng dữ liệu liệt kê không thay đổi mà không có bất kỳ sự tương tác nào từ chính ứng dụng. Điều này có nghĩa là dữ liệu liệt kê nhất quán nếu ứng dụng không thực hiện bất kỳ các lệnh gọi ioctl khác trong khi nó chạy phép liệt kê khoảng thời gian khung.

Lưu ý

Frame intervals and frame rates: The V4L2 API uses frame intervals instead of frame rates. Given the frame interval the frame rate can be computed as follows:

frame_rate = 1 / frame_interval

7.16.5. Cấu trúc

Trong các cấu trúc bên dưới, ZZ0000ZZ biểu thị một giá trị phải được điền bởi ứng dụng, ZZ0001ZZ biểu thị các giá trị mà trình điều khiển điền vào. ứng dụng sẽ loại bỏ tất cả các thành viên ngoại trừ các trường ZZ0002ZZ.

type v4l2_frmival_stepwise
struct v4l2_frmival_stepwise

struct v4l2_fract

min

Minimum frame interval [s].

struct v4l2_fract

max

Maximum frame interval [s].

struct v4l2_fract

step

Frame interval step size [s].
type v4l2_frmivalenum
struct v4l2_frmivalenum

__u32

index

IN: Index of the given frame interval in the enumeration.

__u32

pixel_format

IN: Pixel format for which the frame intervals are enumerated.

__u32

width

IN: Frame width for which the frame intervals are enumerated.

__u32

height

IN: Frame height for which the frame intervals are enumerated.

__u32

type

OUT: Frame interval type the device supports.

union {

(anonymous)

OUT: Frame interval with the given index.

struct v4l2_fract

discrete

Frame interval [s].

struct v4l2_frmival_stepwise

stepwise

}

__u32

reserved[2]

Reserved space for future use. Must be zeroed by drivers and applications.

7.16.6. Enum

type v4l2_frmivaltypes
enum v4l2_frmivaltypes

V4L2_FRMIVAL_TYPE_DISCRETE

1

Discrete frame interval.

V4L2_FRMIVAL_TYPE_CONTINUOUS

2

Continuous frame interval.

V4L2_FRMIVAL_TYPE_STEPWISE

3

Step-wise defined frame interval.

7.16.7. Giá trị trả về

Khi thành công, trả về 0, lỗi -1 và biến ZZ0001ZZ được đặt một cách thích hợp. Các mã lỗi chung được mô tả tại Chương ZZ0000ZZ.