Vietnamese (machine translation)

• English

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 MEDIA_IOC_ENUM_ENTITIES

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.6. ioctl MEDIA_IOC_ENUM_ENTITIES

5.6.1. Tên

MEDIA_IOC_ENUM_ENTITIES - Liệt kê các thực thể và thuộc tính của chúng

5.6.2. Tóm tắt

MEDIA_IOC_ENUM_ENTITIES

ZZ0000ZZ

5.6.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.6.4. Sự miêu tả

Để truy vấn các thuộc tính của một thực thể, các ứng dụng sẽ đặt trường id của một thực thể cấu trúc ZZ0000ZZ và gọi MEDIA_IOC_ENUM_ENTITIES ioctl bằng một con trỏ tới đây cấu trúc. Trình điều khiển lấp đầy phần còn lại của cấu trúc hoặc trả về một Mã lỗi EINVAL khi id không hợp lệ.

Các thực thể có thể được liệt kê bằng cách hoặc thêm id với Cờ ZZ0000ZZ. Lái xe sẽ trả lại thông tin về thực thể có id nhỏ nhất lớn hơn id được yêu cầu một (‘thực thể tiếp theo’) hoặc mã lỗi ZZ0001ZZ nếu không có.

ID thực thể có thể không liền kề. Các ứng dụng ZZ0000ZZ phải thử liệt kê các thực thể bằng cách gọi MEDIA_IOC_ENUM_ENTITIES với mức tăng dần id cho đến khi họ gặp lỗi.

type media_entity_desc

struct media_entity_desc

__u32	id		Entity ID, set by the application. When the ID is or’ed with MEDIA_ENT_ID_FLAG_NEXT, the driver clears the flag and returns the first entity with a larger ID. Do not expect that the ID will always be the same for each instance of the device. In other words, do not hardcode entity IDs in an application.
char	name[32]		Entity name as an UTF-8 NULL-terminated string. This name must be unique within the media topology.
__u32	type		Entity type, see Media entity functions for details.
__u32	revision		Entity revision. Always zero (obsolete)
__u32	flags		Entity flags, see Media entity flags for details.
__u32	group_id		Entity group ID. Always zero (obsolete)
__u16	pads		Number of pads
__u16	links		Total number of outbound links. Inbound links are not counted in this field.
__u32	reserved[4]		Reserved for future extensions. Drivers and applications must set the array to zero.
union {	(anonymous)
struct	dev		Valid for (sub-)devices that create a single device node.
	__u32	major	Device node major number.
	__u32	minor	Device node minor number.
__u8	raw[184]
}

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