acxcircuit.h ヘッダー

このヘッダーは、ACX オーディオ クラス拡張機能によって使用されます。

詳細については、次を参照してください。

• ACX オーディオ クラス拡張機能の概要

• オーディオ

注意

ACX ヘッダーとライブラリは、WDK 10.0.22621.2428 (2023 年 10 月 24 日リリース) には含まれていませんが、以前のバージョンと WDK の最新 (25000 シリーズ ビルド) Insider Preview で使用できます。 WDK のプレビュー バージョンの詳細については、「 Windows Driver Kit (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 関数は、1 つ以上のイベントを ACXCIRCUIT に追加します。
AcxCircuitAddPhysicalConnections AcxCircuitAddPhysicalConnections 関数は、ACXCIRCUIT に物理接続を追加します。
AcxCircuitAddPins AcxCircuitAddPins 関数は、ACXCIRCUIT にピンを追加します。
AcxCircuitCreate AcxCircuitCreate 関数は、ACXCIRCUIT を作成するために使用されます。
AcxCircuitDispatchAcxRequest AcxCircuitDispatchAcxRequest は、要求を管理する ACX フレームワークに ACX WDFREQUEST オブジェクトをディスパッチします。
AcxCircuitGetElementById 有効な ElementID 番号を指定すると、AcxCircuitGetElementById 関数は対応する ACXELEMENT オブジェクトを返します。
AcxCircuitGetElementsCount AcxCircuitGetElementsCount 関数は、指定された ACX 回線に接続されている要素の数を取得します。
AcxCircuitGetNotificationId AcxCircuitGetNotificationId 関数は、指定された ACX 回線のオーディオ モジュール通知に使用されるプラグ アンド プレイ通知 ID を取得します。
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 に対して 1 つ以上の ACX メソッドを割り当てます。
AcxCircuitInitAssignName AcxCircuitInitAssignName 関数は、ACXCIRCUIT のフレンドリ名を割り当てます。
AcxCircuitInitAssignProperties AcxCircuitInitAssignProperties 関数は、ACXCIRCUIT に 1 つ以上の ACX プロパティを割り当てます。
AcxCircuitInitDisableDefaultStreamBridgeHandling AcxCircuitInitDisableDefaultStreamBridgeHandling 関数は、マルチ回線環境で ACX の既定のストリーム ブリッジ処理を無効にします。
AcxCircuitInitFree AcxCircuitInitFree 関数は、回線初期化オブジェクトを削除します。
AcxCircuitInitSetAcxCircuitCompositeCallbacks AcxCircuitInitSetAcxCircuitCompositeCallbacks 関数は、ACXCIRCUIT のドライバーの複合コールバックを設定します。
AcxCircuitInitSetAcxCircuitPnpPowerCallbacks AcxCircuitInitSetAcxCircuitPnpPowerCallbacks 関数は、ACXCIRCUIT のドライバーの PNP コールバックを設定します。
AcxCircuitInitSetCircuitType AcxCircuitInitSetCircuitType 関数を使用して、ACXCIRCUIT の回線の種類を設定します。
AcxCircuitInitSetComponentId AcxCircuitInitSetComponentId 関数は、ACXCIRCUIT のコンポーネント ID を設定します。
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 に対して 1 つ以上の ACX メソッドを割り当てます。
AcxFactoryCircuitInitAssignName AcxFactoryCircuitInitAssignName 関数は、ACXFACTORYCIRCUIT のフレンドリ名を割り当てます。
AcxFactoryCircuitInitAssignProperties AcxFactoryCircuitInitAssignProperties 関数は、ACXFACTORYCIRCUIT に 1 つ以上の ACX プロパティを割り当てます。
AcxFactoryCircuitInitFree AcxFactoryCircuitInitFree 関数は、ファクトリ回線初期化オブジェクトを削除します。
AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks 関数は、ACXFACTORYCIRCUIT のドライバーの PNP コールバックを設定します。
AcxFactoryCircuitInitSetComponentId AcxFactoryCircuitInitSetComponentId 関数は、ACXFACTORYCIRCUIT のコンポーネント ID を設定します。
AcxFactoryCircuitInitSetOperationCallbacks AcxFactoryCircuitInitSetOperationCallbacks は、ACXFACTORYCIRCUIT のドライバー ファクトリ操作コールバックを設定します。

コールバック関数

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE コールバックは、ACX マネージャーによって検出および初期化されたときに、複合回線の初期化を行うためにドライバーによって使用されます。
EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE コールバックは、ACX マネージャーによって初期化解除されるときに、複合回線の初期化解除を行うためにドライバーによって使用されます。
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 EVT_ACX_CIRCUIT_RELEASE_HARDWARE コールバックは、ACXCIRCUIT がリリース ハードウェア フェーズにある場合に機能を追加するためにドライバーによって使用されます。
EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUIT EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUIT コールバックは、ドライバーが指定した構成で ACXCIRCUIT オブジェクトを作成する必要がある場合に、ACX によって呼び出されます。
EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUITDEVICE EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUITDEVICE コールバックは、ドライバーが新しい ACXCIRCUIT オブジェクトの WDFDEVICE を作成する必要がある場合に、ACX によって呼び出されます。
EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE コールバックは、ドライバーが ACXCIRCUIT オブジェクトに関連付けられている以前に作成された WDFDEVICE を削除する必要がある場合に、ACX によって呼び出されます。
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 EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE コールバックは、ACXFACTORYCIRCUIT がリリース ハードウェア フェーズにある場合に機能を追加するためにドライバーによって使用されます。

構造

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 プラグ アンド プレイおよび power イベント コールバック関数へのポインターが含まれています。
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列挙では、STOP IO フラグを定義します。