次の方法で共有

AcxDeviceAddFactoryCircuit 関数 (acxdevice.h)

  • [アーティクル]

AcxDeviceAddFactoryCircuit 関数は、オーディオ回線を作成するための WDFDEVICE にファクトリ回線を追加します。

構文

NTSTATUS AcxDeviceAddFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

パラメーター

Device

ACX ファクトリ回線が追加される WDFDEVICE。

Factory

Device パラメーターで指定された、WDFDEVICE に追加する ACX ファクトリ回線。

戻り値

AcxDeviceAddFactoryCircuit は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、NTSTATUS エラー コードが返されます。

備考

ACX ドライバーは、次のシナリオで 1 つ以上の回線を作成できます。

  • 初期化時
  • 実行時に、新しいオーディオ コンポーネントの検出など、外部イベントの副作用として
  • 回路ファクトリとして ACX に登録されているためです。 ACX フレームワークでは、登録済みのファクトリを使用して、ドライバーに新しい回線を作成するよう求めます。

AcxDeviceRemoveFactoryCircuit を使用して、WDFDEVICEからファクトリ回線を削除します。

この関数は、このデバイスの EVT_WDF_DEVICE_PREPARE_HARDWARE コールバック関数からのみ呼び出すことができます。

例

WDFDEVICE                Device;
NTSTATUS                 status;
PCAPTURE_DEVICE_CONTEXT  devCtx;

// Code to initialize WDFDEVICE...

//
// Add control circuit to child's list.
//
status = AcxDeviceAddFactoryCircuit(Device, devCtx->CtrlCircuit);

if (!NT_SUCCESS(status))
{
    ASSERT(FALSE);
    goto exit;
}

ACX の要件

最小 ACX バージョン: 1.0

ACX バージョンの詳細については、ACX バージョンの概要 参照してください。

必要条件

要件 価値
ヘッダー acxdevice.h
IRQL PASSIVE_LEVEL

関連項目