IOCTL_AVC_UPDATE_VIRTUAL_SUBUNIT_INFO IOCTL (avc.h)

Статья
02/22/2024

Код элемента управления IOCTL_AVC_UPDATE_VIRTUAL_SUBUNIT_INFO ввода-вывода управляет перечислением виртуальных вложенных элементов. Он доступен как для пользовательского режима, так и для компонентов режима ядра через диспетчеризацию IRP_MJ_DEVICE_CONTROL. Для обмена данными между драйверами это METHOD_BUFFERED IOCTL, поэтому задайте поля IRP соответствующим образом (IrpStack-Parameters.DeviceIoControl.InputBufferLength> и Irp-AssociatedIrp.SystemBuffer>).

IOCTL_AVC_UPDATE_VIRTUAL_SUBUNIT_INFO используется для добавления или удаления идентификаторов подсоединений одного типа. Последовательные вызовы с другой частью идентификатора адреса подсоединения приводят к изменению количества перечисленных идентификаторов. Обратите внимание, что avc.sys добавляет или удаляет только самые высокие идентификаторы. Это ограничение спецификации AV/C, а не реализация драйвера.

Этот IOCTL использует структуру AVC_SUBUNIT_ADDR_SPEC.

Основной код

IRP_MJ_DEVICE_CONTROL

Блок состояния

В случае успешного выполнения драйвер протокола AV/C устанавливает Irp-IoStatus.Status>в STATUS_SUCCESS.

Возможные другие возвращаемые значения:

Возвращаемое значение	Описание
STATUS_INSUFFICIENT_RESOURCES	Буфер не передан или недостаточно ресурсов для выполнения запроса в реестре.
STATUS_INVALID_BUFFER_SIZE	Буфер, передаваемый в Irp->AssociatedIrp.SystemBuffer, должен быть не меньше размера sizeof(AVC_SUBUNIT_ADDR_SPEC), который включает однобайтовый адрес подсоединителя, но ограничен 32-байтным адресом подсоединителя.
STATUS_INVALID_PARAMETER	Адрес подсоединия был указан неправильно.
STATUS_ACCESS_DENIED	Текущий пользователь имеет недостаточно прав доступа к реестру, чтобы сделать обновление постоянным.