次の方法で共有

AcxDeviceAddCircuit 関数 (acxdevice.h)

  • [アーティクル]

AcxDeviceAddCircuit 関数は、ACX 回線を WDFDEVICE に追加してオーディオ エンドポイントを作成します。

構文

NTSTATUS AcxDeviceAddCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

パラメーター

Device

WDFDEVICE 回線が追加されるデバイスを表します。

Circuit

デバイスに追加する回線。

戻り値

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

備考

オーディオ回線は、ACX のコア 構成要素です。 オーディオ ドライバーは、部分的または完全なオーディオ データと制御パスを表す 1 つ以上の ACX 回線オブジェクトを作成します。 ACX はこれらの ACX 回線オブジェクトを組み立てて、オーディオ エンドポイントを表す完全なオーディオ パスを作成します。

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

例

WDFDEVICE             Device;
NTSTATUS              status;
PCODEC_DEVICE_CONTEXT devCtx;

// Code to initialize the WDFDEVICE...

devCtx = GetCodecDeviceContext(Device);
ASSERT(devCtx != NULL);

//
// Add static circuit to device's list.
//
ASSERT(devCtx->Render);
status = AcxDeviceAddCircuit(Device, devCtx->Render);

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

ACX の要件

最小 ACX バージョン: 1.0

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

必要条件

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

関連項目