acxcircuit.h 標頭

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

如需詳細資訊，請參閱：

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

• 音訊

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 函式會為 ACXFACTORYCIRCUIT 指派一組驅動程式類別 (GUID) 專案。
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 Manager 偵測並初始化複合線路時執行任何初始化。
EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE 驅動程式會使用EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE回呼，在 ACX Manager 取消初始化複合線路時執行任何取消初始化。
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 當驅動程式必須刪除先前建立的 WDFDEVICE 與 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旗標。