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 |