Создание ключей свойств устройства из дескриптора ОС MS в встроенном ПО камеры класса ВИДЕО USB (UVC)

Статья
02/12/2024

В прошлом производителям usb-видеоклассов (UVC) приходилось создавать пользовательские INF-файлы для предоставления функциональных возможностей, таких как ключи свойств устройства. Для простых разделов реестра драйвер USBVideo имеет механизм создания разделов реестра из дескриптора ОС MS, если имя ключа предваряется UVC-. Это расширяет возможности драйвера USBVideo, чтобы также создавать ключи свойств устройства из дескриптора ОС MS, если он соответствует определенному формату. Это позволяет встроенному ПО камеры USBVideo достичь четности функций с драйвером камеры MIPI без создания пользовательского INF-файла для этих камер.

Примечание

Если один и тот же ключ свойства устройства определен в пользовательском inf, он переопределит значение, предоставленное дескриптором ОС MS.

Применяется к

Windows 11 и более поздних версий операционных систем

Дескриптор свойства реестра MS OS 2.0

Текущий дескриптор свойства реестра MS OS 2.0 определяется следующим образом:

Offset	Поле	Size	Описание
0	wLength	2	Длина этого дескриптора в байтах.
2	wDescriptorType	2	MS_OS_20_FEATURE_REG_PROPERTY
4	wPropertyDataType	2	Тип свойства реестра
6	wPropertyNameLength	2	Длина имени свойства.
8	PropertyName	Переменная	Имя свойства реестра.
8+M	wPropertyDataLength	2	Длина данных свойства
10+M	PropertyData	Переменная	Данные свойств

Значения wPropertyDataType для дескриптора свойств реестра MS OS 2.0

В следующей таблице описаны значения wPropertyDataType для дескриптора свойств реестра MS OS 2.0:

Значение	Описание
0	RESERVED
1	Строка Юникода с завершением NULL (REG_SZ)
2	Строка Юникода, завершающаяся null, которая включает переменные среды (REG_EXPAND_SZ)
3	Двоичный файл в свободной форме (REG_BINARY)
4	32-разрядное целое число (REG_DWORD_LITTLE_ENDIAN)
5	32-разрядное целое число (REG_DWORD_BIG_ENDIAN)
6	Строка Юникода, заканчивающаяся null, которая содержит символьную ссылку (REG_LINK)
7	Несколько строк Юникода с завершением NULL (REG_MULTI_SZ)
8 и выше	RESERVED

Драйвер USBVideo в настоящее время копирует все дескрипторы UVC- ОС MS с префиксом в качестве имен переменных реестра в каждый узел интерфейса устройства. Это прямые копии одного раздела реестра в другой с удалением UVC- префикса. Для ключей свойств устройства требуются дополнительные сведения. Для определения ключа свойства устройства должны быть определены GUID и идентификатор. Кроме того, каждому ключу требуется соответствующий тип данных и значение для этих данных. Для этой функции драйвер USBVideo сопоставляет значение реестра и тип с DEVPROPTYPE.

Возможные типы реестра

Значение реестра	Описание	Значение DEVPROPTYPE	Описание
1	REG_SZ	DEVPROP_TYPE_STRING	Строка, заканчивающаяся null
2	REG_EXPAND_SZ	Н/Д	Не поддерживается
3	REG_BINARY	DEVPROP_TYPE_BINARY	Пользовательские двоичные данные
4	REG_DWORD_LITTLE_ENDIAN	DEVPROP_TYPE_UINT32	32-разрядная версия int без знака (ULONG32)
5	REG_DWORD_BIG_ENDIAN	Н/Д	Не поддерживается
6	REG_LINK	Н/Д	Не поддерживается
7	REG_MULTI_SZ	DEVPROP_TYPE_STRING_LIST	Список строк с несколькими sz

Чтобы определить, что этот ключ свойства устройства должен быть создан, будет определен новый префикс. Если дескриптор ОС MS найден в формате DKEY-GUID,ID<>>,< драйвер USBVideo попытается создать его. Значение реестра должно иметь один из указанных выше форматов (отмена и игнорирование REG_LINK, REG_EXPAND_SZ и REG_DWORD_BIG_ENDIAN). Формат GUID должен быть {XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXXXX}, а формат идентификатора должен быть числовым значением больше 2.

Пример дескриптора ОС MS

В следующем примере определяется дескриптор ОС MS:

UCHAR Example2_MSOS20DescriptorSet_UVCDevicePropertyKeyForFutureWindows\[0x3C\] =
{

//
// MS OS 2.0 Descriptor Set Header
//
0x0A, 0x00, // wLength - 10 bytes
0x00, 0x00, // MSOS20_SET_HEADER_DESCRIPTOR
0x00, 0x00, 0x0?, 0x06, // dwWindowsVersion – 0x060?0000 for future Windows version
0x76, 0x00, // wTotalLength – 118 bytes

//
// MS OS 2.0 Registry Value Feature Descriptor
//
0x6c, 0x00, // wLength - 108 bytes
0x04, 0x00, // wDescriptorType – 4 for Registry Property
0x04, 0x00, // wPropertyDataType - 4 for REG_DWORD_LITTLE_ENDIAN
0x5E, 0x00, // wPropertyNameLength – 94 bytes
'D', 0x00, 'K', 0x00, // Property Name – **DKEY-{4023440c-a74e-46e0-82df-e486fa545f40},3**
'E', 0x00, 'Y', 0x00,
'-', 0x00, '{', 0x00,
'4', 0x00, '0', 0x00,
'2', 0x00, '3', 0x00,
'4', 0x00, '4', 0x00,
'0', 0x00, 'C', 0x00,
'-', 0x00, 'A', 0x00,
'7', 0x00, '4', 0x00,
'E', 0x00, '-', 0x00,
'4', 0x00, '6', 0x00,
'E', 0x00, '0', 0x00,
'-', 0x00, '8', 0x00,
'2', 0x00, 'D', 0x00,
'F', 0x00, '-', 0x00,
'E', 0x00, '4', 0x00,
'8', 0x00, '6', 0x00,
'F', 0x00, 'A', 0x00,
'5', 0x00, '4', 0x00,
'5', 0x00, 'F', 0x00,
'4', 0x00, '0', 0x00,
'}', 0x00, ',', 0x00,
'3', 0x00, 0x00, 0x00,
0x00, 0x00,
0x04, 0x00, // wPropertyDataLength – 4 bytes
0xAC, 0x03, 0x00, 0x00 // PropertyData – 0x000003AC (940)
};

Он преобразуется в следующий ключ свойства устройства с помощью IoSetDevicePropertyData со следующими параметрами:

DEVPROPKEY

    DEVPROPGUID = {4023440c-a74e-46e0-82df-e486fa545f40}

    DEVPROPID = 3

DEVPROPTYPE = DEVPROP_TYPE_UINT32

PropertyBuffer containing UINT32 value = 940

Поделиться через