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