acxcircuit.h 標頭

ACX 音訊類別延伸模組會使用此標頭。

如需詳細資訊，請參閱：

• ACX 音訊類別延伸模組概觀

• 音訊

注意

ACX 標頭和程式庫不包含在 WDK 10.0.22621.2428 (2023 年 10 月 24 日發行) ，但可在舊版中取得，以及 25000 系列組建的最新 (25000 系列組建，) WDK Insider Preview。 如需 WDK 預覽版本的詳細資訊，請參閱 安裝 Windows 驅動程式套件的預覽版本 (WDK) 。

acxcircuit.h 包含下列程式設計介面：

函式

ACX_CIRCUIT_COMPOSITE_CALLBACKS_INIT ACX_CIRCUIT_COMPOSITE_CALLBACKS_INIT函式會初始化ACX_CIRCUIT_COMPOSITE_CALLBACKS結構。
ACX_CIRCUIT_PNPPOWER_CALLBACKS_INIT ACX_CIRCUIT_PNPPOWER_CALLBACKS_INIT函式會初始化ACX_CIRCUIT_PNPPOWER_CALLBACKS結構。
ACX_FACTORY_CIRCUIT_ADD_CIRCUIT_INIT ACX_FACTORY_CIRCUIT_ADD_CIRCUIT_INIT函式會初始化ACX_FACTORY_CIRCUIT_ADD_CIRCUIT結構。
ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS_INIT ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS_INIT函式會初始化ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS組態結構。
ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS_INIT ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS_INIT函式會初始化ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS結構。
ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT_INIT ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT_INIT函式會初始化 ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT 結構。
AcxCircuitAddConnections AcxCircuitAddConnections 函式會將連線新增至 ACXCIRCUIT。
AcxCircuitAddElements AcxCircuitAddElements 函式會將元素新增至 ACXCIRCUIT。
AcxCircuitAddEvents AcxCircuitAddEvents 函式會將一或多個事件新增至 ACXCIRCUIT。
AcxCircuitAddPhysicalConnections AcxCircuitAddPhysicalConnections 函式會將實體連線新增至 ACXCIRCUIT。
AcxCircuitAddPins AcxCircuitAddPins 函式會將針腳新增至 ACXCIRCUIT。
AcxCircuitCreate AcxCircuitCreate 函式可用來建立 ACXCIRCUIT。
AcxCircuitDispatchAcxRequest AcxCircuitDispatchAcxRequest 會將 ACX WDFREQUEST 物件分派至將管理要求的 ACX 架構。
AcxCircuitGetElementById 提供有效的 ElementID 編號時，AcxCircuitGetElementById 函式會傳回對應的 ACXELEMENT 物件。
AcxCircuitGetElementsCount AcxCircuitGetElementsCount 函式會擷取附加至指定 ACX 線路的專案數目。
AcxCircuitGetNotificationId AcxCircuitGetNotificationId 函式會擷取用於指定 ACX 線路之音訊模組通知的隨插即用通知識別碼。
AcxCircuitGetPinById 提供有效的 PinID 號碼時，AcxCircuitGetPinById 函式會傳回對應的 ACXPIN 物件。
AcxCircuitGetPinsCount AcxCircuitGetPinsCount 函式會擷取指定線路物件的針腳數目。
AcxCircuitGetSymbolicLinkName AcxCircuitGetSymbolicLinkName 函式會擷取指定線路物件的符號連結名稱。
AcxCircuitGetWdfDevice 假設有現有的 ACX Circuit 物件，AcxCircuitGetWdfDevice 函式會傳回相關聯的 WDFDEVICE 物件。
AcxCircuitInitAllocate AcxCircuitInitAllocate 函式可用來初始化 AcxCircuitCreate 函式所使用的不透明ACXCIRCUIT_INIT結構。
AcxCircuitInitAssignAcxCreateStreamCallback AcxCircuitInitAssignAcxCreateStreamCallback 函式可用來指派 ACX 建立資料流程回呼。
AcxCircuitInitAssignAcxRequestPreprocessCallback AcxCircuitInitAssignAcxRequestPreprocessCallback 函式會新增 WDFREQUEST 預處理器回呼。
AcxCircuitInitAssignCategories AcxCircuitInitAssignCategories 函式會為 ACXCIRCUIT 指派一組 KSCATERGORY 專案。
AcxCircuitInitAssignComponentUri AcxCircuitInitAssignComponentUri 函式會將 URI 字串指派為 ACXCIRCUIT 的識別碼。
AcxCircuitInitAssignMethods AcxCircuitInitAssignMethods 函式會為 ACXCIRCUIT 指派一或多個 ACX 方法。
AcxCircuitInitAssignName AcxCircuitInitAssignName 函式會指派 ACXCIRCUIT 的易記名稱。
AcxCircuitInitAssignProperties AcxCircuitInitAssignProperties 函式會為 ACXCIRCUIT 指派一或多個 ACX 屬性。
AcxCircuitInitDisableDefaultStreamBridgeHandling AcxCircuitInitDisableDefaultStreamBridgeHandling 函式會在多線路環境中停用 ACX 預設串流網橋處理。
AcxCircuitInitFree AcxCircuitInitFree 函式會刪除線路初始化物件。
AcxCircuitInitSetAcxCircuitCompositeCallbacks AcxCircuitInitSetAcxCircuitCompositeCallbacks 函式會設定 ACXCIRCUIT 的驅動程式複合回呼。
AcxCircuitInitSetAcxCircuitPnpPowerCallbacks AcxCircuitInitSetAcxCircuitPnpPowerCallbacks 函式會設定 ACXCIRCUIT 的驅動程式 PNP 回呼。
AcxCircuitInitSetCircuitType AcxCircuitInitSetCircuitType 函式可用來設定 ACXCIRCUIT 的線路類型。
AcxCircuitInitSetComponentId AcxCircuitInitSetComponentId 函式會設定 ACXCIRCUIT 的元件識別碼。
AcxCircuitResumeIo AcxCircuitResumeIo 函式可用來在暫時停止之後繼續線路 I/O。
AcxCircuitResumeIoActual AcxCircuitResumeIoActual 函式可用來在停止之後繼續線路 I/O。
AcxCircuitResumeIoWithTag AcxCircuitResumeIoWithTag 函式可用來在停止之後繼續線路 I/O。
AcxCircuitStopIo AcxCircuitStopIo 函式可用來向作業系統發出訊號，以暫時停止線路 I/O。
AcxCircuitStopIoActual AcxCircuitStopIoActual 函式可用來向作業系統發出訊號，以暫時停止線路 I/O。
AcxCircuitStopIoWithTag AcxCircuitStopIoWithTag 函式可用來向作業系統發出訊號，以暫時停止線路 I/O。
AcxFactoryCircuitAddElements AcxFactoryCircuitAddElements 函式會將元素新增至 ACXFACTORYCIRCUIT。
AcxFactoryCircuitCreate AcxFactoryCircuitCreate 函式可用來建立 ACXFACTORYCIRCUIT。
AcxFactoryCircuitGetSymbolicLinkName AcxFactoryCircuitGetSymbolicLinkName 函式會擷取指定 ACX 處理站線路的符號連結名稱。
AcxFactoryCircuitInitAllocate AcxFactoryCircuitInitAllocate 函式可用來初始化 AcxFactoryCircuitCreate 函式所使用的不透明ACXFACTORYCIRCUIT_INIT結構。
AcxFactoryCircuitInitAssignAcxRequestPreprocessCallback AcxFactoryCircuitInitAssignAcxRequestPreprocessCallback 函式會新增 WDFREQUEST 前置處理回呼。
AcxFactoryCircuitInitAssignCategories AcxFactoryCircuitInitAssignCategories 函式會指派一組驅動程式類別， (GUID) ACXFACTORYCIRCUIT 的專案。
AcxFactoryCircuitInitAssignComponentUri AcxFactoryCircuitInitAssignComponentUri 函式會將 URI 字串指派為 ACXFACTORYCIRCUIT 的識別碼。
AcxFactoryCircuitInitAssignMethods AcxCircuitFactoryInitAssignMethods 函式會為 ACXFACTORYCIRCUIT 指派一或多個 ACX 方法。
AcxFactoryCircuitInitAssignName AcxFactoryCircuitInitAssignName 函式會指派 ACXFACTORYCIRCUIT 的易記名稱。
AcxFactoryCircuitInitAssignProperties AcxFactoryCircuitInitAssignProperties 函式會為 ACXFACTORYCIRCUIT 指派一或多個 ACX 屬性。
AcxFactoryCircuitInitFree AcxFactoryCircuitInitFree 函式會刪除處理站線路初始化物件。
AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks 函式會設定 ACXFACTORYCIRCUIT 的驅動程式 PNP 回呼。
AcxFactoryCircuitInitSetComponentId AcxFactoryCircuitInitSetComponentId 函式會設定 ACXFACTORYCIRCUIT 的元件識別碼。
AcxFactoryCircuitInitSetOperationCallbacks AcxFactoryCircuitInitSetOperationCallbacks 會設定 ACXFACTORYCIRCUIT 的驅動程式處理站作業回呼。

回呼函式

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE 驅動程式會使用EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE回呼，在 ACX 管理員偵測並初始化複合線路時執行任何初始化。
EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE 當 ACX Manager 取消初始化複合線路時，驅動程式會使用EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE回呼來執行任何複合線路的初始化。
EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE 驅動程式會使用EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE回呼，在 ACX 管理員組合複合端點之後執行任何後續初始化。
EVT_ACX_CIRCUIT_CREATE_STREAM 驅動程式會定義EVT_ACX_CIRCUIT_CREATE_STREAM回呼，以建立線路資料流程實例。
EVT_ACX_CIRCUIT_POWER_DOWN 驅動程式會使用EVT_ACX_CIRCUIT_POWER_DOWN回呼，在 ACXCIRCUIT 物件的關閉電源路徑中新增功能。
EVT_ACX_CIRCUIT_POWER_UP 驅動程式會使用EVT_ACX_CIRCUIT_POWER_UP回呼，在 ACXCIRCUIT 物件的電源增加路徑中新增功能。
EVT_ACX_CIRCUIT_PREPARE_HARDWARE 當線路處於準備硬體階段時，驅動程式會使用EVT_ACX_CIRCUIT_PREPARE_HARDWARE回呼來新增功能。
EVT_ACX_CIRCUIT_RELEASE_HARDWARE 當 ACXCIRCUIT 處於發行硬體階段時，驅動程式會使用EVT_ACX_CIRCUIT_RELEASE_HARDWARE回呼來新增功能。
EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUIT 當驅動程式必須使用指定的組態建立 ACXCIRCUIT 物件時，ACX 會叫用EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUIT回呼。
EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUITDEVICE 當驅動程式必須為新的 ACXCIRCUIT 物件建立 WDFDEVICE 時，ACX 會叫用EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUITDEVICE回呼。
EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE 當驅動程式必須刪除與 ACXCIRCUIT 物件相關聯的先前建立 WDFDEVICE 時，ACX 會叫用EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE回呼。
EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN 驅動程式會使用EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN回呼，在 ACXFACTORYCIRCUIT 物件的電源關閉路徑中新增功能。
EVT_ACX_FACTORY_CIRCUIT_POWER_UP 驅動程式會使用EVT_ACX_FACTORY_CIRCUIT_POWER_UP回呼，在 ACXFACTORYCIRCUIT 物件的電源增加路徑中新增功能。
EVT_ACX_FACTORY_CIRCUIT_PREPARE_HARDWARE 當線路處理站處於準備硬體階段時，驅動程式會使用EVT_ACX_FACTORY_CIRCUIT_PREPARE_HARDWARE回呼來新增功能。
EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE 當 ACXFACTORYCIRCUIT 處於發行硬體階段時，驅動程式會使用EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE回呼來新增功能。

結構

ACX_CIRCUIT_COMPOSITE_CALLBACKS ACX_CIRCUIT_COMPOSITE_CALLBACKS 結構可識別 ACX 複合線路作業的驅動程式回呼。
ACX_CIRCUIT_PNPPOWER_CALLBACKS ACX_CIRCUIT_PNPPOWER_CALLBACKS 結構包含 ACXCIRCUIT 隨插即用和電源事件回呼函式的指標。
ACX_FACTORY_CIRCUIT_ADD_CIRCUIT ACX_FACTORY_CIRCUIT_ADD_CIRCUIT 結構可用來新增 ACX 線路處理站的線路。
ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS 結構會識別 ACX 處理站作業的驅動程式回呼。
ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS 結構包含 ACXFACTORYCIRCUIT 隨插即用和電源事件回呼函式的指標。
ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT 結構可用來移除 ACX 線路處理站線路。

列舉

ACX_CIRCUIT_TYPE ACX_CIRCUIT_TYPE列舉會定義 ACXCIRCUIT 的類型。
ACX_FACTORY_CIRCUIT_ADD_CIRCUIT_FLAGS ACX_FACTORY_CIRCUIT_ADD_CIRCUIT_FLAGS列舉定義處理站線路新增旗標。
ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT_FLAGS ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT_FLAGS列舉定義處理站線路移除旗標。
ACX_STOP_IO_FLAGS ACX_STOP_IO_FLAGS列舉會定義停止 IO 旗標。