fuchsia.driver.development

用於在 CompositeList 中分頁。

GetNext

一次最多可傳回 100 個項目。如果尚無其他複合，則傳回空白。

要求

<EMPTY>

回應

名稱	類型
`composites`	`vector<CompositeNodeInfo>`

CompositeNodeSpecIterator

GetNext

如果沒有其他節點群組，則傳回空白。

要求

<EMPTY>

回應

名稱	類型
`specs`	`vector<fuchsia.driver.framework/CompositeInfo>`

DriverInfoIterator

GetNext

如果沒有剩餘項目，則會傳回空白。

要求

<EMPTY>

回應

名稱	類型
`drivers`	`vector<fuchsia.driver.framework/DriverInfo>`

經理

驅動程式庫開發管理員的介面。這個介面只應用於開發作業，在發布子版本中則停用。

AddTestNode

在根節點下新增測試節點。

要求

名稱	類型
`args`	`TestNodeAddArgs`

回應

名稱	類型
`payload`	`Manager_AddTestNode_Result`

BindAllUnboundNodes

嘗試繫結拓撲中的所有未繫結節點。傳回新的成功繫結。

要求

<EMPTY>

回應

名稱	類型
`payload`	`Manager_BindAllUnboundNodes_Result`

DisableDriver

停用具有指定驅動程式庫元件網址的驅動程式庫。系統不會將已停用的驅動程式比對節點。如果提供 |package_hash|，則系統只會停用特定版本的驅動程式庫套件。否則，適用於具有指定網址的驅動程式庫的所有現有版本。如果沒有任何驅動程式受到影響，系統會傳回 ZX_ERR_NOT_FOUND 錯誤。

要求

名稱	類型
`driver_url`	`fuchsia.url/Url`
`package_hash`	`string[64]?`

回應

名稱	類型
`payload`	`Manager_DisableDriver_Result`

EnableDriver

啟用具有指定驅動程式庫元件網址的驅動程式庫。這項操作只會還原 |DisableDriver| 動作。如果沒有任何驅動程式受到影響，系統會傳回 ZX_ERR_NOT_FOUND 錯誤。

要求

名稱	類型
`driver_url`	`fuchsia.url/Url`
`package_hash`	`string[64]?`

回應

名稱	類型
`payload`	`Manager_EnableDriver_Result`

GetCompositeInfo

傳回系統中的複合項目清單。這包括尚未組合及新增至節點拓撲的複合資料。

要求

名稱	類型
`iterator`	`server_end<CompositeInfoIterator>`

GetCompositeNodeSpecs

傳回系統已知的所有複合式節點規格清單。如果提供 |name_filter|，則傳回清單只會包含 1 個規格，也就是具有該名稱的規格。

|iterator| 關閉時出現以下錯誤： ZX_ERR_NOT_FOUND 表示沒有規格，或提供了 |name_filter|，表示沒有該名稱的規格。

要求

名稱	類型
`name_filter`	`string?`
`iterator`	`server_end<CompositeNodeSpecIterator>`

GetDriverInfo

傳回系統已知的所有驅動程式清單。如果提供 |driver_filter|，系統會篩選傳回的清單，僅包含篩選器中指定的驅動程式。

|iterator| 關閉時出現以下錯誤： ZX_ERR_NOT_FOUND 表示 |driver_filter| 中沒有至少 1 個驅動程式庫的指定路徑的驅動程式庫。 ZX_ERR_BUFFER_TOO_SMALL 表示驅動程式庫的繫結程式長度超出指示數量上限 (BIND_PROGRAM_XXXS_MAX)。

要求

名稱	類型
`driver_filter`	`vector<string>`
`iterator`	`server_end<DriverInfoIterator>`

GetNodeInfo

傳回在系統上執行的節點清單。

如果提供 |node_filter|，系統會篩選傳回的清單，僅納入篩選器中指定的節點。如果 |完全比對| 為 true，則篩選器必須與節點的序數路徑完全相符，否則就會執行子字串比對。如果沒有節點符合篩選器，清單將為空白。

|iterator| 關閉時出現下列錯誤：ZX_ERR_BAD_PATH 表示指定路徑無效。ZX_ERR_BUFFER_TOO_SMALL 表示指定路徑過長，或節點含有的屬性數量超過上限 (PROPERTIES_MAX)。

要求

名稱	類型
`node_filter`	`vector<string>`
`iterator`	`server_end<NodeInfoIterator>`
`exact_match`	`bool`

RemoveTestNode

移除測試節點。節點會以非同步方式移除，且不保證會在這個傳回時移除節點。

要求

名稱	類型
`name`	`string[1024]`

回應

名稱	類型
`payload`	`Manager_RemoveTestNode_Result`

RestartDriverHosts

重新啟動所有包含 driver_url 指定驅動程式的驅動程式庫主機，並傳回已重新啟動的驅動程式庫主機數量。系統會使用 |rematch_flags| 來決定要在哪些節點中繫結現有驅動程式庫，以及應再次執行比對程序的節點。

要求

名稱	類型
`driver_url`	`fuchsia.url/Url`
`rematch_flags`	`RestartRematchFlags`

回應

名稱	類型
`payload`	`Manager_RestartDriverHosts_Result`

NodeInfoIterator

GetNext

如果沒有剩餘項目，則會傳回空白。

要求

<EMPTY>

回應

名稱	類型
`nodes`	`vector<NodeInfo>`

結構化

Manager_AddTestNode_Response

<EMPTY>

Manager_BindAllUnboundNodes_Response

欄位	類型	說明	預設
`binding_result`	`vector<NodeBindingInfo>[10]`	因而造成的新繫結清單。	無預設

Manager_DisableDriver_Response

<EMPTY>

Manager_EnableDriver_Response

<EMPTY>

Manager_RemoveTestNode_Response

<EMPTY>

Manager_RestartDriverHosts_Response

欄位	類型	說明	預設
`count`	`uint32`		無預設

資料表

CompositeNodeInfo

包含複合式節點的資訊。

序數	欄位	類型	說明
1	`parent_topological_paths`	`vector<string>`	此複合式實體的父項節點的拓撲路徑，以索引排序。
2	`topological_path`	`string`	已建立的複合式節點的邏輯路徑。如果沒有建立，則為空白。
3	`composite`	`CompositeInfo`

NodeBindingInfo

驅動程式庫或複合式節點繫結的相關資訊。

序數	欄位	類型	說明
1	`node_name`	`string[1024]`	節點的完整拓撲名稱。
2	`driver_url`	`fuchsia.url/Url`	這是繫結至節點的驅動程式庫的元件網址。如果有，則不得為 \|Composite_parents\| 和 \|legacy_Composite_parents\|。
3	`composite_parents`	`vector<fuchsia.driver.framework/CompositeParent>`	這個節點繫結的複合父項。可以和 \|legacy_Composite_parents\| 搭配使用，但不能與 \|driver_url\| 一起出現。
4	`legacy_composite_parents`	`vector<fuchsia.driver.legacy/CompositeParent>`	這個節點繫結的舊版複合父項。可以與 \|Composite_parents\| 一起出現，但不能與 \|driver_url\| 一起出現。

NodeInfo

序數	欄位	類型	說明
1	`id`	`uint64`	識別節點的專屬 ID。
2	`parent_ids`	`vector<uint64>`	代表父項的 ID 清單。如有多個，即為複合式節點。
3	`child_ids`	`vector<uint64>`	代表子項的 ID 清單。
4	`driver_host_koid`	`zx/Koid`	驅動程式主機所在程序 KOID。
5	`bound_driver_url`	`fuchsia.url/Url`	驅動程式庫元件資訊清單的網址
6	`versioned_info`	`VersionedNodeInfo`	使用中驅動程式庫架構版本的專屬資訊。已淘汰：18 新增時間：17
7	`moniker`	`string[1024]`	節點的集合相關路徑名稱。新增時間：18 歲
8	`node_property_list`	`vector<fuchsia.driver.framework/NodeProperty>[64]`	節點的屬性。新增時間：18 歲
9	`offer_list`	`vector<fuchsia.component.decl/Offer>`	元件會提供給節點新增時間：18 歲

TestNodeAddArgs

序數	欄位	類型	說明
1	`name`	`string[1024]`	節點名稱。
2	`properties`	`vector<fuchsia.driver.framework/NodeProperty>[64]`	節點的屬性。

V1DeviceInfo

已淘汰：18 新增時間：17

序數	欄位	類型	說明
1	`topological_path`	`string[1024]`	驅動程式庫的道理路徑。
2	`bound_driver_libname`	`string[1024]`	驅動程式庫共用資料庫的路徑。
3	`property_list`	`fuchsia.driver.legacy/DevicePropertyList`	裝置屬性。
4	`flags`	`fuchsia.driver.legacy/DeviceFlags`	追蹤裝置狀態。
5	`protocol_id`	`uint32`	Banjo 通訊協定 ID
6	`protocol_name`	`string`	Banjo 通訊協定名稱

V2NodeInfo

序數	欄位	類型	說明
1	`moniker`	`string[1024]`	節點的集合相關路徑名稱。
2	`node_property_list`	`vector<fuchsia.driver.framework/NodeProperty>[64]`	節點的屬性。
3	`offer_list`	`vector<fuchsia.component.decl/Offer>`	元件會提供給節點

聯合國

CompositeInfo 嚴格

包含複合或舊版複合資料的資訊。

序數	Variant	類型	說明
1	`legacy_composite`	`fuchsia.driver.legacy/CompositeInfo`
2	`composite`	`fuchsia.driver.framework/CompositeInfo`

Manager_AddTestNode_Result 嚴格

序數	Variant	類型
1	`response`	`Manager_AddTestNode_Response`
2	`err`	`fuchsia.driver.framework/NodeError`
3	`framework_err`	`internal`

Manager_BindAllUnboundNodes_Result 嚴格

序數	Variant	類型
1	`response`	`Manager_BindAllUnboundNodes_Response`
2	`err`	`zx/Status`
3	`framework_err`	`internal`

Manager_DisableDriver_Result 嚴格

序數	Variant	類型
1	`response`	`Manager_DisableDriver_Response`
2	`err`	`zx/Status`
3	`framework_err`	`internal`

Manager_EnableDriver_Result 嚴格

序數	Variant	類型
1	`response`	`Manager_EnableDriver_Response`
2	`err`	`zx/Status`
3	`framework_err`	`internal`

Manager_RemoveTestNode_Result 嚴格

序數	Variant	類型
1	`response`	`Manager_RemoveTestNode_Response`
2	`err`	`zx/Status`
3	`framework_err`	`internal`

Manager_RestartDriverHosts_Result 嚴格

序數	Variant	類型
1	`response`	`Manager_RestartDriverHosts_Response`
2	`err`	`zx/Status`
3	`framework_err`	`internal`

VersionedNodeInfo 彈性

已淘汰：18 新增時間：17

序數	Variant	類型	說明
1	`v1`	`V1DeviceInfo`
2	`v2`	`V2NodeInfo`

帳單

RestartRematchFlags 彈性

類型：uint32