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 バージョンの概要」を参照してください。

要件

要件 値
Header acxdevice.h
IRQL PASSIVE_LEVEL

こちらもご覧ください