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 DMX_QBUF, DMX_DQBUF

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/.

3.2.20. ioctl DMX_QBUF, DMX_DQBUF

3.2.20.1. Tên

DMX_QBUF - DMX_DQBUF - Trao đổi bộ đệm với trình điều khiển

Cảnh báo

this API is still experimental

3.2.20.2. Tóm tắt

DMX_QBUF

ZZ0000ZZ

DMX_DQBUF

ZZ0000ZZ

3.2.20.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.

3.2.20.4. Sự miêu tả

Các ứng dụng gọi ZZ0000ZZ ioctl để xếp hàng trống Bộ đệm (chụp) hoặc đầy (đầu ra) trong hàng đợi đến của trình điều khiển. Ngữ nghĩa phụ thuộc vào phương pháp I/O đã chọn.

Để xếp hàng các ứng dụng bộ đệm, hãy đặt trường ZZ0004ZZ. chỉ mục hợp lệ các số nằm trong khoảng từ 0 đến số lượng bộ đệm được phân bổ bằng ZZ0000ZZ (cấu trúc ZZ0001ZZ ZZ0005ZZ) trừ một. Nội dung của struct ZZ0002ZZ được trả về bởi ZZ0003ZZ ioctl cũng sẽ làm được.

Khi ZZ0000ZZ được gọi với một con trỏ tới cấu trúc này, nó sẽ khóa các trang bộ nhớ của bộ đệm trong bộ nhớ vật lý nên chúng không thể hoán đổi được ra đĩa. Bộ đệm vẫn bị khóa cho đến khi được xếp hàng đợi, cho đến khi thiết bị đã đóng.

Các ứng dụng gọi ZZ0001ZZ ioctl để loại bỏ một (chụp) bộ đệm từ hàng đợi gửi đi của trình điều khiển. Họ chỉ đặt trường ZZ0002ZZ có ID bộ đệm sẽ được xếp hàng đợi. Khi ZZ0003ZZ được gọi bằng một con trỏ tới cấu trúc ZZ0000ZZ, trình điều khiển điền vào các trường còn lại hoặc trả về mã lỗi.

Theo mặc định, ZZ0001ZZ sẽ chặn khi không có bộ đệm ở đầu ra xếp hàng. Khi cờ ZZ0002ZZ được trao cho Hàm ZZ0000ZZ, trả về ZZ0003ZZ ngay lập tức kèm theo mã lỗi ZZ0004ZZ khi không có bộ đệm.

Cấu trúc ZZ0000ZZ được chỉ định trong ZZ0001ZZ.

3.2.20.5. 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.

EAGAIN

I/O không chặn đã được chọn bằng ZZ0000ZZ và không bộ đệm nằm trong hàng đợi gửi đi.

EINVAL

ZZ0000ZZ nằm ngoài giới hạn hoặc chưa có bộ đệm nào được phân bổ.

EIO

ZZ0000ZZ không thành công do lỗi nội bộ. Cũng có thể chỉ ra các sự cố tạm thời như mất tín hiệu hoặc lỗi CRC.