acxpin.h 標頭

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

如需詳細資訊，請參閱：

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

• 音訊

注意

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

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

函式

ACX_CONNECTION_INIT 初始化ACX_CONNECTION結構，以用於設定連接。
ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION_INIT ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION_INIT函式會初始化ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION結構以供使用。
ACX_JACK_CALLBACKS_INIT ACX_JACK_CALLBACKS_INIT函式會初始化ACX_JACK_CALLBACKS結構以供使用。
ACX_JACK_CONFIG_INIT ACX_JACK_CONFIG_INIT宏會呼叫具有預設識別碼值的 ACX_JACK_CONFIG_INIT_ID 函式。
ACX_JACK_CONFIG_INIT_ID ACX_JACK_CONFIG_INIT_ID函式會使用指定的識別碼，初始化ACX_JACK_CONFIG結構。
ACX_MICARRAYGEOMETRY_CONFIG_INIT ACX_MICARRAYGEOMETRY_CONFIG_INIT函式會初始化ACX_MICARRAYGEOMETRY_CONFIG結構以供使用。
ACX_MICROPHONE_CONFIG_INIT ACX_MICROPHONE_CONFIG_INIT函式已初始化ACX_MICROPHONE_CONFIG結構以供使用。
ACX_PHYSICAL_CONNECTION_INIT ACX_PHYSICAL_CONNECTION_INIT函式會初始化ACX_PHYSICAL_CONNECTION結構以供使用。
ACX_PIN_CALLBACKS_INIT ACX_PIN_CALLBACKS_INIT函式會初始化ACX_PIN_CALLBACKS結構以供使用。
ACX_PIN_CONFIG_INIT ACX_PIN_CONFIG_INIT宏會呼叫具有預設識別碼值的 ACX_PIN_CONFIG_INIT_ID 函式。
ACX_PIN_CONFIG_INIT_ID ACX_PIN_CONFIG_INIT_ID函式會使用指定的識別碼，初始化ACX_PIN_CONFIG結構。
AcxJackChangeStateNotification AcxJackChangeStateNotification 函式表示指定的插孔狀態發生變更。
AcxJackCreate AcxJackCreate 函式會建立並初始化新的音訊插孔物件。
AcxMicArrayGeometryAddMicrophoneCoordinates AcxMicArrayGeometryAddMicrophoneCoordinates 函式會將實體座標新增至麥克風陣列幾何。
AcxMicArrayGeometryCreate AcxMicArrayGeometryCreate 函式會建立並初始化新的 ACXMICARRAYGEOMETRY 物件。
AcxPinAddEvents AcxPinAddEvents 函式會將事件陣列新增至指定的針腳。
AcxPinAddJacks AcxPinAddJacks 函式會將插孔陣列新增至指定的針腳。
AcxPinAddStreamBridges AcxPinAddStreamBridges 函式會將串流網橋新增至指定的針腳。
AcxPinAssignModeDataFormatList AcxPinAssignModeDataFormatList 函式會將模式資料格式清單指派給指定的針腳。
AcxPinCreate AcxPinCreate 函式會建立並初始化新的 ACXPIN 物件。
AcxPinGetCircuit AcxPinGetCircuit 函式會傳回連接針腳的線路。
AcxPinGetId AcxPinGetId 函式會傳回指定針腳的識別碼。
AcxPinGetRawDataFormatList AcxPinGetRawDataFormatList 函式會傳回指定針腳的原始模式資料格式清單。
AcxPinGetType AcxPinGetType 函式會傳回指定針腳的類型。
AcxPinNotifyDataFormatChange 呼叫 AcxPinNotifyDataFormatChange 函式，以產生指定針腳的資料格式變更通知事件。
AcxPinRemoveModeDataFormatList AcxPinRemoveModeDataFormatList 函式會刪除指定釘選的模式資料格式清單。
AcxPinRemoveStreamBridges AcxPinRemoveStreamBridges 函式會從指定的針腳移除 ACXSTREAMBRIDGE 物件。
AcxPinRetrieveModeDataFormatList AcxPinRetrieveModeDataFormatList 函式會取得指定針腳的模式資料格式清單。

回呼函式

EVT_ACX_JACK_RETRIEVE_PRESENCE_STATE 驅動程式會實作EVT_ACX_JACK_RETRIEVE_PRESENCE_STATE回呼函式，並在要求指定插孔的狀態時呼叫。
EVT_ACX_PIN_CONNECTED 驅動程式會實作EVT_ACX_PIN_CONNECTED回呼函式，並線上路橋接器接腳連接到另一個線路的橋接器接點時呼叫。
EVT_ACX_PIN_DATAFORMAT_CHANGE_NOTIFICATION EVT_ACX_PIN_DATAFORMAT_CHANGE_NOTIFICATION回呼函式是由驅動程式實作，並在指定的針腳發生資料格式變更時呼叫。
EVT_ACX_PIN_DISCONNECTED 驅動程式會實作EVT_ACX_PIN_DISCONNECTED回呼函式，並線上路橋接器接點與另一個線路的針腳中斷連線時呼叫。
EVT_ACX_PIN_RETRIEVE_JACK_SINK_INFO 驅動程式會實作EVT_ACX_PIN_RETRIEVE_JACK_SINK_INFO回呼函式，並在要求指定針腳的接收資訊時呼叫。
EVT_ACX_PIN_RETRIEVE_NAME 驅動程式會實作EVT_ACX_PIN_RETRIEVE_NAME回呼函式，並在要求指定針腳的名稱時呼叫。
EVT_ACX_PIN_SET_DATAFORMAT 驅動程式會實作EVT_ACX_PIN_SET_DATAFORMAT回呼函式，並呼叫 以設定指定針腳的資料格式。

結構

ACX_CONNECTION ACX_CONNECTION結構是用來定義兩個針腳之間的連線。
ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION 結構會指定回送音訊與麥克風音訊交錯的方式，以進行KSPROPERTY_INTERLEAVEDAUDIO_FORMATINFORMATION。
ACX_JACK_CALLBACKS ACX_JACK_CALLBACKS 結構會指定音訊插孔事件回呼函式。
ACX_JACK_CONFIG ACX_JACK_CONFIG 結構是用來設定音訊插孔。
ACX_JACK_DESCRIPTION ACX_JACK_DESCRIPTION 結構描述音訊插孔的屬性，例如連線類型、實體位置等等。
ACX_JACK_SINK_INFORMATION ACX_JACK_SINK_INFORMATION結構會指定顯示器相關數位音訊裝置的相關資訊，例如 HDMI 裝置或顯示埠。
ACX_MIC_ARRAY_GEOMETRY ACX_MIC_ARRAY_GEOMETRY 結構會指定麥克風陣列的類型和幾何。
ACX_MICARRAYGEOMETRY_CONFIG ACX_MICARRAYGEOMETRY_CONFIG結構可用來設定麥克風陣列。
ACX_MICROPHONE_CONFIG ACX_MICROPHONE_CONFIG結構是用來設定麥克風。
ACX_MICROPHONE_COORDINATES ACX_MICROPHONE_COORDINATES 結構會指定 X、Y 和 Z 座標中麥克風的 3D 位置。
ACX_PHYSICAL_CONNECTION ACX_PHYSICAL_CONNECTION結構描述兩個 ACXCIRCUIT 物件之間的實體音訊連線。
ACX_PIN_CALLBACKS ACX_PIN_CALLBACKS 結構會指定針腳事件回呼函式。
ACX_PIN_CONFIG ACX_PIN_CONFIG 結構是用來設定針腳。

列舉

ACX_CONNECTION_FLAGS ACX_CONNECTION 結構會使用ACX_CONNECTION_FLAGS列舉來指定 ACX 物件識別碼類型。
ACX_JACK_CONFIG_FLAGS ACX_JACK_CONFIG_FLAGS列舉可用來描述實體插孔對音訊類別延伸模組的屬性， (ACX) 。
ACX_JACK_CONNECTION_TYPE ACX_JACK_CONNECTION_TYPE列舉是用來描述實體連接插孔的類型。
ACX_JACK_GEN_LOCATION ACX_JACK_GEN_LOCATION列舉是由ACX_JACK_DESCRIPTION結構用來協助描述系統中音訊插孔的一般位置。
ACX_JACK_GEO_LOCATION ACX_JACK_GEO_LOCATION列舉是由ACX_JACK_DESCRIPTION結構用來協助描述音訊插孔的幾何位置。
ACX_JACK_PORT_CONNECTION ACX_JACK_DESCRIPTION 結構會使用ACX_JACK_PORT_CONNECTION列舉，並指定由插孔表示的埠類型。
ACX_JACK_SINK_INFO_CONNECTION_TYPE ACX_JACK_SINK_INFO_CONNECTION_TYPE列舉是由ACX_JACK_SINK_INFORMATION結構用來指定連接的類型。
ACX_MIC_ARRAY_TYPE ACX_MIC_ARRAY_TYPE列舉是用來指定麥克風陣列的類型。
ACX_MICARRAYGEOMETRY_CONFIG_FLAGS ACX_MICARRAYGEOMETRY_CONFIG_FLAGS列舉是用來設定麥克風陣列的幾何。
ACX_MICROPHONE_CONFIG_FLAGS ACX_MICROPHONE_CONFIG_FLAGS列舉是用來設定實體麥克風。
ACX_MICROPHONE_TYPE ACX_MICROPHONE_TYPE列舉可用來識別麥克風的取貨模式。
ACX_PHYSICAL_CONNECTION_FLAGS ACX_PHYSICAL_CONNECTION_FLAGS列舉是由ACX_PHYSICAL_CONNECTION結構用來初始化實體連線。
ACX_PIN_COMMUNICATION ACX_PIN_CONFIG 結構會使用ACX_PIN_COMMUNICATION列舉來表示針腳的通訊類型。
ACX_PIN_CONFIG_FLAGS ACX_PIN_CONFIG_FLAGS列舉會指定ACX_PIN_CONFIG結構中使用的針腳組態設定。
ACX_PIN_QUALIFIER ACX_PIN_QUALIFIER列舉指定在多線路音訊拓撲中如何連接 PIN。
ACX_PIN_TYPE ACX_PIN_CONFIG 結構會使用ACX_PIN_TYPE列舉來表示針腳的類型。