acxtargets.h 標頭

ACX 音訊類別延伸模組會使用 acxtargets 標頭。 如需詳細資訊，請參閱 ACX 音訊類別延伸模組概觀。

WdfIoTarget 是一種 WDF 抽象概念，可促進兩個不同的堆疊之間的通訊。 ACX 使用 WdfIoTarget 來促進 ACX 物件、線路、針腳、串流、元素和線路處理站之間的通訊。

ACX 會使用下列 ACX 物件來支援目標之間的通訊。 如需詳細資訊，請參閱 ACX - ACX 物件的摘要。

驅動程式會使用 AcxTargetCircuit 來與不同堆疊公開的遠端線路通訊。 AcxTargetCircuit 是使用 WdfIoTarget 來實作。

驅動程式會使用 AcxTargetPin 與不同堆疊所公開的遠端線路針腳通訊。 AcxTargetPin 是使用 WdfIoTarget 實作，以將訊息傳送至遠端釘選實體。

驅動程式會使用 AcxTargetStream 來與不同堆疊所公開的遠端線路串流通訊。 AcxTargetStream 是使用 WdfIoTarget 來實作，以建立遠端資料流並變更遠端資料流的狀態。

驅動程式會使用 AcxTargetElement 來與不同堆疊所公開的遠端線路元素通訊。 AcxTargetElement 是使用 WdfIoTarget 實作，以將訊息傳送至遠端元素實體。

驅動程式會使用 AcxTargetFactoryCircuit 與遠端線路處理站實例通訊。 AcxTargetFactoryCircuit 是使用 WdfIoTarget 實作，以將訊息傳送至遠端線路處理站。

為了與遠端線路互動，上述每個 ACX 類型都支援：

• properties
• 方法
• 活動

如需詳細資訊，請參閱：

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

• ACX - ACX 物件的摘要

• 音訊

注意

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

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

函式

ACX_TARGET_CIRCUIT_CONFIG_INIT ACX_TARGET_CIRCUIT_CONFIG_INIT函式會初始化 ACX 目標線路組態結構。
ACX_TARGET_FACTORY_CIRCUIT_CONFIG_INIT ACX_TARGET_FACTORY_CIRCUIT_CONFIG_INIT函式會初始化 ACX 目標處理站線路組態結構。
ACX_TARGET_STREAM_CONFIG_INIT ACX_TARGET_STREAM_CONFIG_INIT函式會初始化 ACX 目標資料流程組態結構。
AcxTargetCircuitCreate AcxTargetCircuitCreate 函式是用來建立 ACX 目標線路。
AcxTargetCircuitFormatRequestForMethod AcxTargetCircuitFormatRequestForMethod 會將 WDFREQUEST 格式化為 ACX 方法要求，以用於指定的線路目標。
AcxTargetCircuitFormatRequestForProperty AcxTargetCircuitFormatRequestForProperty 會將 WDFREQUEST 格式化為要用於指定線路目標的 ACX 屬性要求。
AcxTargetCircuitGetElementsCount AcxTargetCircuitGetElementsCount 函式會傳回遠端目標上的 ACX 元素計數。
AcxTargetCircuitGetPinsCount AcxTargetCircuitGetPinsCount 函式會傳回遠端目標上的 ACX 針腳計數。
AcxTargetCircuitGetSymbolicLinkName AcxTargetCircuitGetSymbolicLinkName 函式會擷取 指定 ACX 目標線路的符號連結名稱。
AcxTargetCircuitGetTargetElement 根據有效的元素索引值，AcxTargetCircuitGetTargetElement 函式會傳回相關聯的 ACXTARGETELEMENT 物件。
AcxTargetCircuitGetTargetPin 根據有效的針腳索引值，AcxTargetCircuitGetTargetPin 函式會傳回相關聯的 ACXTARGETPIN 物件。
AcxTargetCircuitGetWdfIoTarget AcxTargetCircuitGetWdfIoTarget 函式會傳回相關聯的 WDFIOTARGET 物件。
AcxTargetElementFormatRequestForMethod AcxTargetElementFormatRequestForMethod 函式會將 WDFREQUEST 格式化為要用於指定專案目標上的 ACX 方法要求。
AcxTargetElementFormatRequestForProperty AcxTargetElementFormatRequestForProperty 會將 WDFREQUEST 格式化為要用於指定專案目標上的 ACX 屬性要求。
AcxTargetElementGetId 根據現有的 ACXTARGETELEMENT 物件，AcxTargetElementGetId 會傳回其對應的識別碼值。
AcxTargetElementGetNameTag 根據現有的 ACXTARGETELEMENT 物件，AcxTargetElementGetNameTag 會以 GUID 的形式傳回其名稱標記。
AcxTargetElementGetType 根據現有的 ACXTARGETELEMENT 物件，AcxTargetElementGetType 函式會以 GUID 的形式傳回其對應的元素類型。
AcxTargetElementGetWdfIoTarget 根據現有的 ACXTARGETELEMENT 物件，AcxTargetElementGetWdfIoTarget 會傳回其對應的 WDFIOTARGET 物件。
AcxTargetFactoryCircuitCreate AcxTargetFactoryCircuitCreate 函式會傳回新 ACXTARGETFACTORYCIRCUIT ACX 物件的控制碼。
AcxTargetFactoryCircuitFormatRequestForMethod AcxTargetFactoryCircuitFormatRequestForMethod 會將 WDFREQUEST 格式化為要用於指定線路處理站目標的 ACX 方法要求。
AcxTargetFactoryCircuitFormatRequestForProperty AcxTargetFactoryCircuitFormatRequestForProperty 會將 WDFREQUEST 格式化為要用於指定線路處理站目標的 ACX 屬性要求。
AcxTargetFactoryCircuitGetWdfIoTarget 根據現有的 ACXTARGETFACTORYCIRCUIT 物件，AcxTargetFactoryCircuitGetWdfIoTarget 會傳回其對應的 WDFIOTARGET 物件。
AcxTargetPinFlushModeDataFormatListCache AcxTargetPinFlushModeDataFormatListCache 函式會排清指定目標釘選的模式資料格式清單快取。
AcxTargetPinFormatRequestForMethod AcxTargetPinFormatRequestForMethod 函式會將 WDFREQUEST 格式化為 ACX 方法要求，以用於指定的針腳目標。
AcxTargetPinFormatRequestForProperty AcxTargetPinFormatRequestForProperty 會將 WDFREQUEST 格式化為要用於指定釘選目標上的 ACX 屬性要求。
AcxTargetPinGetId 給定現有 ACXTARGETPIN 物件的 AcxTargetPinGetId 會傳回其相關聯的識別碼值。
AcxTargetPinGetWdfIoTarget 根據現有的 ACXTARGETPIN 物件，AcxTargetPinGetWdfIoTarget 函式會傳回其對應的 WDFIOTARGET 物件。
AcxTargetPinRetrieveModeDataFormatList 根據現有的 ACXTARGETPIN 物件，AcxTargetPinRetrieveModeDataFormatList 函式會傳回與指定訊號處理模式資料格式清單相關聯的 ACXDATAFORMATLIST。
AcxTargetStreamAssignDrmContentId 根據現有的 ACXTARGETSTREAM 物件，AcxTargetStreamAssignDrmContentId 函式會將 DRM 內容識別碼指派給該資料流程。
AcxTargetStreamCreate AcxTargetStreamCreate 函式可用來建立目標資料流程。
AcxTargetStreamFormatRequestForMethod AcxTargetStreamFormatRequestForMethod 會將 WDFREQUEST 格式化為要用於指定資料流程目標上的 ACX 方法要求。
AcxTargetStreamFormatRequestForProperty AcxTargetStreamFormatRequestForProperty 會將 WDFREQUEST 格式化為要用於指定資料流程目標上的 ACX 屬性要求。
AcxTargetStreamGetElementsCount 指定 ACXTARGETSTREAM 物件的 AcxTargetStreamGetElementsCount 函式會傳回其 ACX 元素數目。
AcxTargetStreamGetTargetElement AcxTargetStreamGetTargetElement 函式指定有效的元素索引值，會傳回與指定資料流程相關聯的對應 ACXTARGETELEMENT ACX 物件。
AcxTargetStreamGetWdfIoTarget AcxTargetStreamGetWdfIoTarget 函式會傳回與指定資料流程相關聯的 WDFIOTARGET WDF 物件。

結構

ACX_TARGET_CIRCUIT_CONFIG ACX_TARGET_CIRCUIT_CONFIG 結構可用來定義目標線路組態。
ACX_TARGET_FACTORY_CIRCUIT_CONFIG ACX_TARGET_FACTORY_CIRCUIT_CONFIG 結構可用來定義目標處理站線路組態。
ACX_TARGET_STREAM_CONFIG ACX_TARGET_STREAM_CONFIG 結構可用來定義目標資料流程組態。

列舉

ACX_TARGET_CIRCUIT_CONFIG_FLAGS ACX_TARGET_CIRCUIT_CONFIG_FLAGS列舉會定義 ACX 目標線路的組態旗標。
ACX_TARGET_FACTORY_CIRCUIT_CONFIG_FLAGS ACX_TARGET_FACTORY_CIRCUIT_CONFIG_FLAGS列舉會定義 ACX 目標線路處理站的組態旗標。
ACX_TARGET_STREAM_CONFIG_FLAGS ACX_TARGET_STREAM_CONFIG_FLAGS列舉會定義 ACX 目標資料流程的組態旗標。