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 |