AcxDeviceAddFactoryCircuit 函式 (acxdevice.h)

  • 發行項

AcxDeviceAddFactoryCircuit 函式會將處理站線路新增至 WDFDEVICE，以建立音訊線路。

語法

NTSTATUS AcxDeviceAddFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

參數

Device

將新增 ACX 處理站線路的 WDFDEVICE 。

Factory

要新增至 Device 參數所指定的 WDFDEVICE 的 ACX 處理站線路。

傳回值

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

備註

ACX 驅動程式可能會在下列案例中建立一或多個線路：

  • 初始化時
  • 在運行時間，作為外部事件的副作用，例如偵測新的音訊元件
  • 因為它已向 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 版本概觀。

規格需求

需求 值
標頭 acxdevice.h
IRQL PASSIVE_LEVEL

另請參閱