AcxDeviceRemoveCircuitDevice 函式 (acxdevice.h)

AcxDeviceRemoveCircuitDevice 函式會從指定的父裝置中移除 ACX 線路裝置。

語法

NTSTATUS AcxDeviceRemoveCircuitDevice(
  WDFDEVICE ParentDevice,
  WDFDEVICE Device
);

參數

ParentDevice

要從中移除 ACX 線路裝置的父 WDFDEVICE 。

Device

WDFDEVICE，代表要從父裝置移除的線路裝置。

傳回值

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

備註

音訊驅動程式會使用此函式來移除現有的音訊端點。

此函式可以隨時在驅動程式的生命週期中呼叫。 隨插即用 會負責串行化裝置的移除，以及與父系和同層級裝置上其他 隨插即用 活動相關的線路。

範例

NTSTATUS status;
WDFDEVICE Device;
WDFDEVICE child;

// Code to initialize WDFDEVICE objects...

// Remove the child device.
status = AcxDeviceRemoveCircuitDevice(Device, child);

if (!NT_SUCCESS(status)) 
{
    ASSERT(FALSE);
    goto exit;
}

ACX 需求

最低 ACX 版本： 1.0

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

規格需求

需求	值
標頭	acxdevice.h
IRQL	PASSIVE_LEVEL

另請參閱

• AcxDeviceRemoveCircuit
• acxdevice.h 標頭