共用方式為

AcxDeviceAddFactoryCircuit 函式 （acxdevice.h）

  • 發行項

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

語法

NTSTATUS AcxDeviceAddFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

參數

Device

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

Factory

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

傳回值

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

另請參閱