USB ビデオ クラス (UVC) カメラ ファームウェアで MS OS 記述子からデバイス プロパティ キーを作成する
以前は、USB ビデオ クラス (UVC) カメラのメーカーは、デバイス プロパティ キーなどの機能を提供するために、カスタム INF ファイルを作成する必要がありました。 単純なレジストリ キーの場合、USBVideo ドライバーには、問題のキー名の先頭にUVC-が付いている場合、MS OS 記述子からレジストリ キーを作成するためのメカニズムがあります。 これにより、USBVideo ドライバーでその機能が拡張され、特定の形式に従っている場合は、MS OS 記述子からデバイス プロパティ キーも作成されます。 これにより、USBVideo カメラ ファームウェアは、これらのカメラのカスタム INF を作成することなく、MIPI カメラ ドライバーとの機能パリティを実現できます。
Note
カスタム INF で同じデバイス プロパティ キーが定義されている場合は、MS OS 記述子によって提供される値がオーバーライドされます。
適用対象
- Windows 11 およびそれ以降のオペレーティング システム
MS OS 2.0 レジストリ プロパティ記述子
現在の MS OS 2.0 レジストリ プロパティ記述子は、次のように定義されています。
| オフセット | フィールド | サイズ | 説明 |
|---|---|---|---|
| 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 | 変数 | プロパティ データ |
MS OS 2.0 レジストリ プロパティ記述子の wPropertyDataType 値
次の表では、MS OS 2.0 レジストリ プロパティ記述子の wPropertyDataType 値について説明します。
| Value | アクリルアミド |
|---|---|
| 0 | RESERVED |
| 1 | ヌル終端 Unicode 文字列 (REG_SZ) |
| 2 | 環境変数を含むヌル終端 Unicode 文字列 (REG_EXPAND_SZ) |
| 3 | 自由形式バイナリ (REG_BINARY) |
| 4 | リトルエンディアン 32 ビット整数 (REG_DWORD_LITTLE_ENDIAN) |
| 5 | ビッグエンディアン 32 ビット整数 (REG_DWORD_BIG_ENDIAN) |
| 6 | シンボリック リンクを含むヌル終端 Unicode 文字列 (REG_LINK) |
| 7 | 複数のヌル終端 Unicode 文字列 (REG_MULTI_SZ) |
| 8 以上 | RESERVED |
USBVideo ドライバーは現在、レジストリ変数名としてUVC-のプレフィックスを持つすべての MS OS 記述子を各デバイス インターフェイス ノードにコピーします。 あるレジストリ キーから別のレジストリ キーへの 1 対 1 の直接コピーがあり、UVC-プレフィックスが削除されます。 デバイス プロパティ キーの場合は、追加情報が必要です。 デバイス プロパティ キーを定義するには、GUID と ID が定義されている必要があります。 さらに、各キーには、対応するデータ型とそのデータの値が必要です。 この機能の場合、USBVideo ドライバーはレジストリ値とタイプをDEVPROPTYPEにマップします。
可能なレジストリ タイプ
| レジストリ値 | 説明 | DEVPROPTYPE 値 | 説明 |
|---|---|---|---|
| 1 | REG_SZ | DEVPROP_TYPE_STRING | ヌル終端文字列 |
| 2 | REG_EXPAND_SZ | NA | サポートされていません |
| 3 | REG_BINARY | DEVPROP_TYPE_BINARY | カスタム バイナリ データ |
| 4 | REG_DWORD_LITTLE_ENDIAN | DEVPROP_TYPE_UINT32 | 32 ビット符号なし整数 (ULONG32) |
| 5 | REG_DWORD_BIG_ENDIAN | NA | サポートされていません |
| 6 | REG_LINK | NA | サポートされていません |
| 7 | REG_MULTI_SZ | DEVPROP_TYPE_STRING_LIST | Multi-sz の文字列リスト |
このデバイス プロパティ キーを作成さらる必要があることを判断するために、新しいプレフィックスが定義されます。 MS OS 記述子がDKEY-<GUID>、<ID>の形式で見つかった場合、USBVideo ドライバーはこの作成を試みます。 レジストリ値は、上記で定義された形式のいずれかである必要があります (REG_LINK、REG_EXPAND_SZ、REG_DWORD_BIG_ENDIAN を破棄して無視ます)。 GUID の形式は {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX} で、ID の形式は 2 より大きい数値にする必要があります。
MS OS 記述子の例
次の例では、MS OS 記述子を定義します。
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