AcxDeviceAddCircuit 函式 (acxdevice.h)

  • 發行項

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

語法

NTSTATUS AcxDeviceAddCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

參數

Device

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

Circuit

要新增至 裝置的線路。

傳回值

如果呼叫成功，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

另請參閱