AcxDeviceAddCircuitDevice 関数 (acxdevice.h)

  • [アーティクル]

AcxDeviceAddCircuitDevice 関数は、オーディオ パスを表す指定された親デバイスに ACX 回線デバイスを追加します。

構文

NTSTATUS AcxDeviceAddCircuitDevice(
  WDFDEVICE ParentDevice,
  WDFDEVICE Device
);

パラメーター

ParentDevice

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

Device

親デバイスに追加する回線デバイスを表す WDFDEVICE 。

戻り値

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

注釈

オーディオ ドライバーでは、この関数を使用して、新しいオーディオ エンドポイントを列挙します。

この関数は、ドライバーのライフ サイクル中にいつでも呼び出すことができます。 プラグ アンド プレイは、親デバイスと兄弟デバイス上の他のプラグ アンド プレイアクティビティに関連して、デバイスの列挙体と関連する回線をシリアル化します。

例

WDFDEVICE Device;
WDFDEVICE renderDevice = NULL;
NTSTATUS  status;

// Code to initialize the WDFDEVICE...

// Code to create the WDFDEVICE renderDevice...

//
// Add circuit to device's dynamic circuit device list.
//
status = AcxDeviceAddCircuitDevice(Device, renderDevice);
if (!NT_SUCCESS(status)) 
{
    ASSERT(FALSE);
    goto exit;
}

ACX の要件

最小 ACX バージョン: 1.0

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

要件

要件 値
Header acxdevice.h
IRQL PASSIVE_LEVEL

こちらもご覧ください