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 |