Функция 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

См. также раздел