IOCTL_KS_PROPERTY IOCTL (ks.h)

Статья
08/07/2023

Приложение может использовать IOCTL_KS_PROPERTY для получения или задания свойств, а также для определения свойств, поддерживаемых объектом KS. Приложение передает IOCTL_KS_PROPERTY с параметрами, описанными ниже, в функцию KsSynchronousDeviceControl .

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Содержимое заданного клиентом параметра InBuffer зависит от запроса на свойство и документируется для каждого набора свойств. Например, клиенты, запрашивающие свойства в наборе свойств KSPROPSETID_Pin , указывают указатель на структуру KSP_PIN .

Длина входного буфера

Приложение помещает размер содержимого входного буфера в байтах в параметр InLength .

Выходной буфер

Аналогичным образом, тип требуемого выходного буфера также зависит от запроса свойства.

Длина выходного буфера

Приложение помещает размер выходного буфера в байтах в параметр OutLength .

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

Если запрос выполнен успешно, для элемента Status устанавливается значение STATUS_SUCCESS.

Фильтры и закрепление поддерживают наборы свойств с помощью элемента управления IOCTL_KS_PROPERTY устройства ввода-вывода. Хотя этот IOCTL определен с флагом METHOD_NEITHER, данные свойства передаются в качестве выходного буфера в IOCTL и проверяются для доступа на чтение. Функция KsPropertyHandler обрабатывает свойства, запрашиваемые с помощью IOCTL_KS_PROPERTY.

Список допустимых флагов и соответствующие описания см. на странице справочника по структуре KSPROPERTY .