IOCTL_KS_PROPERTY IOCTL (ks.h)
Приложение может использовать IOCTL_KS_PROPERTY для получения или задания свойств, а также для определения свойств, поддерживаемых объектом KS. Приложение передает IOCTL_KS_PROPERTY с параметрами, описанными ниже, в функцию KsSynchronousDeviceControl .
Основной код
Входной буфер
Содержимое заданного клиентом параметра InBuffer зависит от запроса на свойство и документируется для каждого набора свойств. Например, клиенты, запрашивающие свойства в наборе свойств KSPROPSETID_Pin , указывают указатель на структуру KSP_PIN .
Длина входного буфера
Приложение помещает размер содержимого входного буфера в байтах в параметр InLength .
Выходной буфер
Аналогичным образом, тип требуемого выходного буфера также зависит от запроса свойства.
Длина выходного буфера
Приложение помещает размер выходного буфера в байтах в параметр OutLength .
Блок состояния
Если запрос выполнен успешно, для элемента Status устанавливается значение STATUS_SUCCESS.
Комментарии
Дополнительные сведения о входных и выходных буферах и их размерах см. в разделе Свойства KS.
Фильтры и закрепление поддерживают наборы свойств с помощью элемента управления IOCTL_KS_PROPERTY устройства ввода-вывода. Хотя этот IOCTL определен с флагом METHOD_NEITHER, данные свойства передаются в качестве выходного буфера в IOCTL и проверяются для доступа на чтение. Функция KsPropertyHandler обрабатывает свойства, запрашиваемые с помощью IOCTL_KS_PROPERTY.
Список допустимых флагов и соответствующие описания см. на странице справочника по структуре KSPROPERTY .
Требования
| Требование | Значение |
|---|---|
| Заголовок | ks.h (включая Ks.h) |