acxDeviceRemoveCircuit 函式 (acxdevice.h)

  • 發行項

AcxDeviceRemoveCircuit 函式會從 ACX 裝置移除指定的音訊線路。

語法

NTSTATUS AcxDeviceRemoveCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

參數

Device

要從中移除 Circuit 參數所指定音訊線路的 WDFDEVICE。

Circuit

要從 Device 參數所指定的 WDFDEVICE 中移除的音訊線路。

傳回值

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

備註

使用 AcxDeviceAddCircuit 將音訊線路新增至 WDFDEVICE。

此函式只能從此裝置 的EVT_WDF_DEVICE_RELEASE_HARDWARE 回呼函式呼叫。

範例

NTSTATUS              status;
WDFDEVICE             Device = NULL;
PUSBA2_DEVICE_CONTEXT devCtx;

// Code to initialize WDFDEVICE...

devCtx = GetDeviceContext(Device);

//
// Unregister filter and delete this audio filter.
//
if (devCtx->RenderCircuitAdded) {
    ASSERT(devCtx->RenderCircuit);
    status = AcxDeviceRemoveCircuit(Device, devCtx->RenderCircuit);

    devCtx->RenderCircuit = NULL;
    devCtx->RenderCircuitAdded = FALSE;
}

ACX 需求

最小 ACX 版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

規格需求

需求 值
標頭 acxdevice.h
IRQL PASSIVE_LEVEL

另請參閱