Функция AcxDeviceRemoveCircuitDevice (acxdevice.h)
Функция AcxDeviceRemoveCircuitDevice удаляет устройство канала ACX из указанного родительского устройства.
Синтаксис
NTSTATUS AcxDeviceRemoveCircuitDevice(
WDFDEVICE ParentDevice,
WDFDEVICE Device
);
Параметры
ParentDevice
Родительский WDFDEVICE, из которого удаляется устройство канала ACX.
Device
WDFDEVICE, представляющий устройство канала, которое нужно удалить с родительского устройства.
Возвращаемое значение
AcxDeviceRemoveCircuitDevice возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается код ошибки NTSTATUS.
Замечания
Звуковые драйверы используют эту функцию для удаления существующей конечной точки звука.
Эта функция может вызываться в любое время во время жизненного цикла драйвера. Plug and Play заботится о сериализации удаления устройства и связанных каналов в связи с другими действиями Plug and Play на родительских и одноуровневых устройствах.
Пример
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 |