ACX 對象的摘要
本主題提供構成 ACX 音訊驅動程式基底之音訊類別延伸模組 （ACX） 物件的高階摘要。 如需 ACX 的一般概觀，請參閱 ACX 音訊類別延伸模組概觀。
ACX 對像是 Windows Driver Framework （WDF） 物件 - WDFOBJECT。 如需 WDF 的詳細資訊，請參閱 Framework 物件簡介。 如需 WDF 物件的摘要，請參閱 Framework 物件的摘要。
ACX 物件階層
在ACX中（如同 WDF 中），驅動程式對像是根物件，而所有其他物件都是其子系/子系。 所有 ACX 物件都是驅動程式物件的子系，直接或間接透過其他 ACX 或 WDF 物件。 ACX 驅動程式可以在建立期間指定 ACX 物件的父代。 如果未指定父代，ACX 會使用預設父代，如下列各節所述。
建立非ACX WDF物件
除了 ACX 物件之外，音訊驅動程式還可以視需要建立及使用其他 WDF 物件。 如果驅動程式計劃列舉非 ACX 裝置，則應該使用與建立 ACX/WDF 裝置時建立的預設 WDF 子清單不同的子清單來執行此動作。 驅動程式可以使用 WdfChildListCreate 建立新的 WDF 子清單，如在函式驅動程式中建立裝置物件中所述。 如需 WDF 物件的一般資訊，請參閱 Windows Driver Foundation 的 Framework 物件、WDF 架構和開發驅動程式簡介。 如需初始化 ACX 裝置的相關信息，請參閱 AcxDeviceInitialize。
ACX 線路
AcxCircuit 代表使用者感知音訊裝置的部分或完整音訊路徑（喇叭、麥克風等）。 AcxCircuit 至少有一個輸入針腳和一個輸出針腳（ACXPIN），而且可能會匯總一或多個類似 AcxElements 的物件。 根據預設，AcxElements 會以相同的元件順序「已連線」。
音訊線路是 ACX 的核心建置組塊。 在新的 ACX 架構中，音訊驅動程式會建立一或多個 ACX 線路物件來代表部分或完整的音訊數據/控制路徑。 ACX 會將這些 ACX 線路物件組合在一起，以建立代表音訊端點的完整音訊路徑。 ACX 負責管理 ACX 線路及其相依性。 這些線路的組裝順序可以在初始化時以靜態方式定義，或在運行時間動態定義。
ACX 架構中的音訊端點是一或多個 ACX 線路的集合。 多重線路音訊路徑中的每個 ACX 線路都必須屬於不同的 PnP 裝置堆疊。 ACX 驅動程式可能會在初始化時建立一或多個線路，或在運行時間建立線路，例如在偵測新的音訊元件之後，或因為它以 ACX 註冊為特定線路類型的處理站，而 ACX 架構要求處理站元件建立該類型的新線路（請參閱本主題稍後所述的 ACX 線路管理員/Factory）。
AcxCircuit 可能有一或多個數據流。
AcxCircuit 有專用的 WDF 佇列。 如需 WDF 佇列的詳細資訊，請參閱 Framework Queue Objects。
ACX 線路的 DIS 會在 acxcircuit.h 標頭中描述。
ACX 針腳
如同 WDM Portcls 音訊驅動程式，而 AcxPin 物件代表邏輯連線（而非實體連線），數據流會從系統通訊總線輸入配接器，或從配接器輸入系統通訊總線。
針腳的 DIS 會在 acxpin.h 標頭中描述。
ACX 數據流
AcxStream 代表特定線路硬體上的音訊串流。 AcxStream 可能會匯總一或多個類似 AcxElements 的物件。 根據預設，AcxElements 會以相同的元件順序「已連線」。 AcxStream 只會與一個 ACX 線路相關聯。
- AcxStream 有專用的 WDF 佇列。 如需 WDF 佇列的詳細資訊，請參閱 Framework Queue Objects
- AcxStream 支援不同的狀態。 這些狀態表示音訊何時流動（RUN 狀態）或未流動（PAUSE 或 STOP 狀態）。
- 目前 ACX 支援兩種類型的數據流：非串流線路所使用的基本 ACX 資料流物件，以及串流線路所使用的 ACX RT 資料流物件。
數據流的 DIS 定義於 acxstreams.h 標頭中。
ACX 目標
WdfIoTarget 是一種 WDF 抽象概念，可促進兩個不同的堆疊之間的通訊。 如需 WDF IO 目標的詳細資訊，請參閱 I/O 目標簡介。
- 驅動程式會使用 AcxTargetCircuit 與不同堆疊公開的遠端線路通訊。 AcxTargetCircuit 是使用 WdfIoTarget 實作。
- 驅動程式會使用 AcxTargetPin 與不同堆疊公開的遠端線路針腳進行通訊。 AcxTargetPin 是使用 WdfIoTarget 實作，以將訊息傳送至遠端釘選實體。
- 驅動程式會使用 AcxTargetElement 與不同堆疊所公開的遠端線路項目通訊。 AcxTargetElement 是使用 WdfIoTarget 實作，以將訊息傳送至遠端元素實體。
- 驅動程式會使用 AcxTargetStream 與不同堆疊公開的遠端線路串流通訊。 AcxTargetStream 是使用 WdfIoTarget 來實作，以建立遠端數據流並變更遠端數據流的狀態。
- 驅動程式會使用 AcxTargetFactoryCircuit 與遠端線路處理站實例通訊。 AcxTargetFactoryCircuit 是使用 WdfTarget 實作，以將訊息傳送至遠端線路處理站。
上述每個 ACX 類型都支援屬性、方法和事件，以與遠端線路互動。 所有這些類型都是建置在 WdfIoTarget 物件之上。
目標的 DIS 定義於 acxtargets.h 標頭中。
ACX 串流網橋
AcxStreamBridge 物件是由線路用來傳播串流建立、串流狀態轉換和線路區段之間的DRM設定。 這個物件只會用於多重線路（音訊複合）案例中。 驅動程式可能會將一或多個 ACXSTREAMBRIDGE 對象與網橋接產生關聯。 網橋接腳是 ACXPIN，會以邏輯方式連接到另一個線路上的對應 ACXPIN。
Stream 的 DIS 會在 acxstreams.h 標頭中描述。
ACX 音訊引擎節點線路配置範例
下圖說明 ACX 線路。 主機和卸除針腳是線路的輸入，具有可用於回應取消的回送針腳。 輸出可能是路由傳送至喇叭的網橋接腳。
請注意，驅動程式不需要在線路/元素以與新增至線路相同的順序連線時，執行明確連接的步驟。
根據預設，ACX 會連接從線路 ACX 要求接收針腳開始的元素，並結束於轉譯和擷取裝置的線路裝置網橋接腳。
ACX 管理員
ACX 管理員用於系統工作，例如支援複合音訊端點。 這些類型的端點是由來自相同或不同廠商的一或多個驅動程式堆疊所管理。 用戶端可以在 ACPI 中預先設定此設定，或使用 ACX 管理員的 DDI。 ACX 管理員的 DIS 會在 acxmanager.h 標頭中描述。
ACX 物件包
ACX 物件包可用來儲存各種數據類型。 ACXOBJECTBAG 可以在各種 DIS 中當做自變數傳遞。 Object Bag 的 DIS 會在 acxmisc.h 標頭中描述。
ACX 物件摘要
下表列出所有 ACX 物件，並提供每個對象的相關一些基本資訊。
| Handle | 名稱 | 目的 |
|---|---|---|
| ACXMANAGER | ACX 管理員 | ACX Manager 對象，用來管理及控制其他物件。 |
| ACXOBJECTBAG | 物件包 | 用於儲存數據以與物件搭配使用。 |
| ACXEVENT | ACX 事件 | 針對 KS （核心串流） 事件。 |
| ACXEVENTDATA | 事件資料 | 與事件相關聯的數據。 |
| ACXPNPEVENT | Pnp 事件 | 針對隨插即用事件。 |
| ACXCIRCUIT | 線路 | 本主題中所述的ACX線路。 |
| ACXPIN | 釘選 | ACX pin 物件代表邏輯連線，如本主題所述。 |
| ACXELEMENT | 元素 | 用來代表任何可新增至 AcxCircuit 或 AcxStream 的專案，例如 AcxVolume |
| ACXAUDIOENGINE | 音訊引擎 | 用於轉譯線路來表示 DSP 的 ACX 音訊引擎。 |
| ACXSTREAMAUDIOENGINE | 串流音訊引擎 | 在轉譯數據流中用來表示 DSP。 |
| ACXKEYWORDSPOTTER | 關鍵詞識別器 | 關鍵詞 spotter，用於擷取線路中的音訊串流中的關鍵詞偵測。 |
| ACXVOLUME | 體積 | 用來表示磁碟區、增益、提升。 |
| ACXMUTE | 靜音 | 用來表示靜音專案。 |
| ACXJACK | 千斤頂 | 用來代表音訊插孔或其他實體連接器。 |
| ACXMICARRAYGEOMETRY | 麥克風陣組幾何 | 用來代表麥克風陣組幾何，例如麥克風的位置。 |
| ACXPEAKMETER | 尖峰計量 | 當硬體支援尖峰計量功能時使用。 |
| ACXSTREAM | 串流 | 用來代表線路所建立的音訊串流，如本主題所述。 |
| ACXDATAFORMAT | 資料格式 | 數據格式代表音訊裝置所支援的數據格式。 |
| ACXDATAFORMATLIST | 數據格式清單 | 可供使用的音訊數據格式清單。 |
| ACXTARGETCIRCUIT | 目標線路 | 用來與不同堆疊公開的遠端線路通訊。 |
| ACXTARGETPIN | 目標釘選 | 用來與不同堆疊公開的遠端線路針腳進行通訊。 |
| ACXTARGETELEMENT | Target 項目 | 用來代表可新增至 AcxCircuit 或 AcxStream 的目標專案，例如 AcxVolume |
| ACXTARGETSTREAM | 目標數據流 | 用來與不同堆疊公開的遠端線路數據流進行通訊。 |
| ACXTARGETFACTORYCIRCUIT | 目標線路處理站 | 用來與遠端線路的處理站通訊。 |
| ACXSTREAMBRIDGE | 串流網橋 | 由線路用來傳播數據流建立、狀態轉換和線路區段之間的DRM。 |
| ACXCOMPOSITE | 複合 | 用來代表多重線路/多堆棧/多廠商串流架構。 |
| ACXCOMPOSITEFACTORY | 複合處理站 | 建立複合音訊線路的處理站。 |
| ACXFACTORYCIRCUIT | 處理站線路 | 使用特定範本建立線路的處理站。 |
| ACXCIRCUITMANAGER | 線路管理員 | 用於建立動態線路的線路提供者。 |
| ACXCOMPOSITETEMPLATE | 複合範本 | 複合範本代表部分或完整的音訊系結。 複合範本可以有一或多個線路範本。 |
| ACXCIRCUITTEMPLATE | 線路範本 | 線路範本代表部分音訊路徑。 |
| ACXAUDIOMODULE | 音訊模組 | 針對自定義第三方新增功能。 |
下列 ACX 物件可用來儲存線路、數據流和線路處理站資訊。
| Handle | 目的 |
|---|---|
| ACXCIRCUIT_INIT | 儲存 ACX 線路初始化數據 |
| ACXSTREAM_INIT | 儲存 ACX 數據流初始化數據 |
| ACXFACTORYCIRCUIT_INIT | 儲存 ACX 線路處理站所使用的初始化數據 |