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:
- 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/.
5.7. ioctl MEDIA_IOC_ENUM_LINKS¶
5.7.1. Tên¶
MEDIA_IOC_ENUM_LINKS - Liệt kê tất cả các phần đệm và liên kết cho một thực thể nhất định
5.7.2. Tóm tắt¶
-
MEDIA_IOC_ENUM_LINKS¶
ZZ0000ZZ
5.7.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.
5.7.4. Sự miêu tả¶
Để liệt kê các phần đệm và/hoặc liên kết cho một thực thể nhất định, các ứng dụng sẽ đặt trường thực thể của cấu trúc ZZ0000ZZ cấu trúc và khởi tạo cấu trúc ZZ0001ZZ và cấu trúc Mảng cấu trúc ZZ0002ZZ được trỏ bởi các trường ZZ0003ZZ và ZZ0004ZZ. Sau đó họ gọi MEDIA_IOC_ENUM_LINKS ioctl với một con trỏ tới cấu trúc này.
Nếu trường ZZ0001ZZ không phải là NULL, trình điều khiển sẽ điền vào mảng ZZ0002ZZ với thông tin về các miếng đệm của thực thể. Mảng phải có đủ phòng để lưu trữ tất cả các miếng đệm của thực thể. Số lượng miếng đệm có thể được lấy ra với ZZ0000ZZ.
Nếu trường ZZ0001ZZ không phải là NULL, trình điều khiển sẽ điền vào mảng ZZ0002ZZ với thông tin về các liên kết ngoài của thực thể. Mảng phải có đủ chỗ để lưu trữ tất cả các liên kết ra ngoài của thực thể. Số lượng các liên kết ngoài có thể được truy xuất bằng ZZ0000ZZ.
Chỉ các liên kết chuyển tiếp bắt nguồn từ một trong các bảng nguồn của thực thể mới được được trả về trong quá trình liệt kê.
-
type media_links_enum¶
__u32 |
|
Entity id, set by the application. |
struct |
* |
Pointer to a pads array allocated by the application. Ignored if NULL. |
struct |
* |
Pointer to a links array allocated by the application. Ignored if NULL. |
__u32 |
|
Reserved for future extensions. Drivers and applications must set the array to zero. |
-
type media_pad_desc¶
__u32 |
|
ID of the entity this pad belongs to. |
__u16 |
|
Pad index, starts at 0. |
__u32 |
|
Pad flags, see Media pad flags for more details. |
__u32 |
|
Reserved for future extensions. Drivers and applications must set the array to zero. |
-
type media_link_desc¶
struct |
|
Pad at the origin of this link. |
struct |
|
Pad at the target of this link. |
__u32 |
|
Link flags, see Media link flags for more details. |
__u32 |
|
Reserved for future extensions. Drivers and applications must set the array to zero. |
5.7.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.
- EINVAL
Cấu trúc ZZ0000ZZ ZZ0001ZZ tham chiếu đến một thực thể không tồn tại.