共用方式為

AcxDeviceAddCircuit 函式 （acxdevice.h）

  • 發行項

AcxDeviceAddCircuit 函式會將 ACX 線路新增至 WDFDEVICE，以建立音訊端點。

語法

NTSTATUS AcxDeviceAddCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

參數

Device

WDFDEVICE，代表將新增線路的裝置。

Circuit

要新增至 Device的線路。

傳回值

AcxDeviceAddCircuit 如果呼叫成功，就會傳回STATUS_SUCCESS。 否則，它會傳回 NTSTATUS 錯誤碼。

言論

音訊線路是 ACX 的核心建置組塊。 音訊驅動程式會建立一或多個 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

另請參閱