MICROSOFT 擴充至 USB 視訊類別 1.5 規格

概觀

1.1 摘要

USB 視訊類別規格的 Microsoft 延伸模組可啟用新的控件，以及以標準格式攜帶定義完善的框架元數據的功能。

1.2 架構決策

ISOCH 和 BULK 端點可以使用 USB 視訊類別 （UVC） 畫面元數據支援。 不過，在 BULK 端點的情況下，元數據大小限制為 240 個字節（因為所有視訊畫面數據都會在 BULK 端點上的單一視訊畫面封包中傳輸）。

UVC 元數據支援僅適用於框架式承載。

UVC 元數據支援僅適用於媒體基礎 （MF） 擷取管線。

UVC 元數據是選擇加入。 每個需要元數據支援的 IHV/OEM 都必須透過自訂 INF 檔案啟用。

UVC 元數據僅支援系統配置的記憶體。 不支援 VRAM 或 DX 表面。

2 架構概觀

2.1 描述

2.2.1 透過 INF 的功能探索

2.2.1.1 仍然擷取映射 – 方法 2

某些現有的UVC裝置可能不支援在USB視訊類別規格網站上下載的UVC 1.5類別specification.pdf第2節2.4.2.4.2.4（仍然影像擷取）中所述的方法 2。

在 Windows 10 版本 1607 和更早版本中，即使裝置根據 UVC 1.5 規格公告支援它，擷取管線也不會使用方法 2。

在 Windows 10 版本 1703 中，使用此方法的裝置必須使用相機驅動程式的自定義 INF 檔案，但指定硬體需要自定義 INF，才能啟用方法 2 仍會擷取影像）。

注意：相機驅動程式可以以 Windows USBVIDEO.SYS為基礎，也可以以自定義驅動程式二進位檔為基礎。

根據自訂 UVC 驅動程式或收件匣 UVC 驅動程式的自訂 INF 檔案應該包含下列 AddReg 專案：

EnableDependentStillPinCapture： REG_DWORD： 0x0 （Disabled） 至 0x1 （Enabled）

當這個項目設定為 Enabled （0x1），擷取管線會使用方法 2 進行靜止影像擷取（假設韌體也會公告支援 UVC 1.5 規格所指定的方法 2）。

自訂 INF 區段的範例如下：

[USBVideo.NT.Interfaces]
AddInterface=%KSCATEGORY_CAPTURE%,GLOBAL,USBVideo.Interface
AddInterface=%KSCATEGORY_RENDER%,GLOBAL,USBVideo.Interface
AddInterface=%KSCATEGORY_VIDEO%,GLOBAL,USBVideo.Interface
AddInterface=%KSCATEGORY_RENDER_EXT%,GLOBAL,USBVideo.Interface
AddInterface=%KSCATEGORY_VIDEO_CAMERA%,GLOBAL,USBVideo.Interface

[USBVideo.Interface]
AddReg=USBVideo.Interface.AddReg

[USBVideo.Interface.AddReg]
HKR,,CLSID,,%ProxyVCap.CLSID%
HKR,,FriendlyName,,%USBVideo.DeviceDesc%
HKR,,RTCFlags,0x00010001,0x00000010
HKR,,EnableDependentStillPinCapture,0x00010001,0x00000001

2.2.2 擴充單元控件

Microsoft 啟用新控件的 USB 視訊類別規格延伸模組是透過 GUID MS_CAMERA_CONTROL_XU 所識別的擴充單元來完成（稱為 Microsoft-XU）。

// {0F3F95DC-2632-4C4E-92C9-A04782F43BC8}
DEFINE_GUID(MS_CAMERA_CONTROL_XU,
    0xf3f95dc, 0x2632, 0x4c4e, 0x92, 0xc9, 0xa0, 0x47, 0x82, 0xf4, 0x3b, 0xc8);

由裝置韌體實作的 Microsoft-XU 會裝載下列小節中定義的新控件。 除非明確為該控件指定覆寫定義，否則下列要求定義會套用至所有這些控件。 如需 D3、D4、GET_INFO 等的定義，請參閱 UVC 1.5 類別specification.pdf 。

GET_INFO要求應報告控件，而不需自動更新和異步功能（例如，D3 和 D4 位應設定為 0）。

GET_LEN要求應報告此控件的承載長度上限（wLength）。

GET_RES要求應報告 qwValue/dwValue 的解析度（步驟大小）。 所有其他欄位都應該設定為 0。

GET_MIN要求應報告 qwValue/dwValue 的最低支援值。 所有其他欄位都應該設定為 0。

GET_MAX要求應報告 qwValue/dwValue 的最大支援值。 此外，所有支援的旗標都應該設定為 bmControlFlags 中的 1。 所有其他欄位都應該設定為 0。

GET_DEF和GET_CUR要求應分別報告 qwValue/dwValue 和 bmControlFlags 字段的預設和目前設定。 所有其他欄位都應該設定為 0。

設定所有欄位之後，主機會發出SET_CUR要求。

下表將 Microsoft-XU 的控件選取器對應至其各自的值，以及延伸單元描述元中 bmControls 字段的位位置：

2.2.2.1 可取消的控件

您可以使用 Autoupdate 功能在這裡定義可取消的控制件。

GET_INFO要求應報告自動更新控件等控件（例如，D3 位應設定為 1），但不應作為異步控件（例如，D4 位應設定為 0）。

針對這類控件，可以發出SET_CUR要求來設定新的值（SET_CUR（NORMAL） 要求，其中 bmOperationFlags：D0 位設定為 0 ），或取消先前的 SET_CUR（NORMAL） 要求（SET_CUR（CANCEL） 要求，其中 bmOperationFlags：D0 位設定為 1）。 當收到要求時，裝置應立即完成SET_CUR要求（即使硬體未設定或交集至所要求的新設定）。 針對每個SET_CUR（NORMAL） 要求，當套用新設定或SET_CUR（CANCEL） 要求送達時，裝置會針對這個控件產生對應的控制變更中斷;直到此中斷到達，SET_CUR（NORMAL） 要求才會被視為進行中。 當SET_CUR（NORMAL） 要求進行時，此特定控件的額外SET_CUR（NORMAL） 要求將會導致失敗。 SET_CUR（CANCEL） 要求一律會成功。 如果沒有取消任何專案，則裝置只會執行任何動作。

如果套用了 SET_CUR（NORMAL） 所指定的設定，則控制變更中斷承載應該將 bit bmOperationFlags：D0 設定為 0 ，如果因為SET_CUR（NORMAL） 要求之後提出的SET_CUR（CANCEL） 要求而未套用設定，則設定為 1（例如，聚合尚未發生）。

2.2.2.2 焦點控制件

此控制項可讓主機軟體指定相機的焦點設定。 這是全域控件，會影響與影片控制介面相關聯之所有視訊串流介面上的所有端點。

此控件應作為可取消的控件運作（如需GET_INFO要求需求和SET_CUR要求的功能行為，請參閱第 2.2.2.1 節）。

GET_MAX需求：此控件應公告 bmControlFlags 中位 D0、D1、D2、D8 和 D18 的支援。

GET_DEF需求：bmControlFlags 的預設值應為 D0 和 D18 設定為 1，dwValue 設定為 0。

針對GET_CUR/SET_CUR要求，下列限制適用於字段 bmControlFlags：

• 在 D0、D1 和 D8 位中，只能設定一個位：如果設定 D2 位，則這些設定都沒有有效。

• 在 D16、D17、D18、D19 和 D20 中，只能設定一個位，其中任何一個都無效。

• D1 與目前定義的所有其他位不相容（D0、D2、D8、D16、D17、D18、D19 和 D20）。

• D2 與 D1 和 D8 不相容。

• 如果未設定 D0，D2 與 D16、D17、D18、D19 和 D20 不相容。

2.2.2.3 曝光控制

此控制項可讓主機軟體指定相機的曝光設定。 這是全域控件，會影響與影片控制介面相關聯之所有視訊串流介面上的所有端點。

GET_INFO要求應將此控件報告為異步控件（例如，D4 位應設定為 1），但不應報告為 AutoUpdate 控件（例如，D3 位應設定為 0）。

GET_MAX需求：此控件應該在 bmControlFlags 中公告對位 D0、D1 和 D2 的支援。

GET_DEF需求：bmControlFlags 的預設值應設定為 D0 設定為 1，而 qwValue 設定為 0。

針對GET_CUR/SET_CUR要求，下列限制適用於字段 bmControlFlags：

• 在 D0、D1 和 D2 位中，至少應設定一個位。
• D1 與 D0 和 D2 不相容。

2.2.2.4 EV 補償控制

此控制項可讓主機軟體指定相機的 EV 補償設定。 這是全域控件，會影響與影片控制介面相關聯之所有視訊串流介面上的所有端點。

GET_INFO要求應將此控件報告為異步控件（例如，D4 位應設定為 1），但不應報告為 AutoUpdate 控件（例如，D3 位應設定為 0）。

GET_RES要求應在 bmControlFlags 中設定對應的位，以報告所有支援的解析度（步驟大小）。 所有其他欄位都應該設定為 0。

GET_MIN和GET_MAX要求應報告 dwValue 支援的最小值和最大值。 位 D4 （表示步驟大小為 1） 應該是 bmControlFlags 中唯一設定的位。 所有其他欄位都應該設定為 0。

GET_DEF，GET_CUR，SET_CUR要求應遵循第 2.2.2.1 節中的定義，但應該在 D0、D1、D2、D3 和 D4 位之間設定一個和一個位。 此外，GET_DEF要求應將 dwValue 設定為 0。

2.2.2.5 白平衡控件

此控制項可讓主機軟體指定相機的白平衡設定。 這是全域控件，會影響與影片控制介面相關聯之所有視訊串流介面上的所有端點。

GET_INFO要求應將此控件報告為異步控件（例如，D4 位應設定為 1），但不應報告為 AutoUpdate 控件（例如，D3 位應設定為 0）。

GET_RES，GET_MIN，GET_MAX要求應遵循第 2.2.2.1 節中的定義，但 dwValueFormat 設定為 1。

GET_MAX需求：此控件應該在 bmControlFlags 中公告對位 D0、D1 和 D2 的支援。

GET_DEF需求：bmControlFlags 的預設值應該是 D0 設定為 1，dwValueFormat 和 dwValue 設定為 0。

針對GET_CUR/SET_CUR要求，下列限制適用於字段 bmControlFlags：

• 在 D0、D1 和 D2 位中，至少應設定一個位。
• D1 與 D0 和 D2 不相容。

2.2.2.6 臉部驗證控件

此控制項可讓主機軟體指定相機是否支援用於臉部驗證的串流模式。 此控件的支援表示相機能夠進行臉部驗證。 否則不支援此控件。

此控件僅適用於能夠產生 Infra-Red（IR） 資料的相機，而且僅適用於指定的串流介面（這是與視訊控制介面相關聯的所有視訊串流介面子集）。

GET_RES和GET_MIN要求應報告 欄位 bNumEntries 設定為 0，因此沒有其他欄位。

針對GET_MAX要求，bmControlFlags 字段上的位設定為1，表示該串流介面支持對應的模式。 GET_MAX要求輸出應該列出所有且只列出能夠 D1 或 D2 的串流介面（例如，如果串流介面能夠 D1 或 D2，則會列出，否則不會列出它）。 此外，不得公告任何串流介面，以同時支援 D1 和 D2。 如果串流介面也打算以一般用途使用（例如，在臉部驗證目的之外），則該串流介面的 D0 應設定為 1（除了 D1/D2）。

針對GET_DEF/GET_CUR/SET_CUR要求，bmControlFlags 欄位上的位設定為 1，表示已針對該串流介面選擇對應的模式。 在這些要求中，應針對特定串流介面設定一個和一個位（在 D0、D1 和 D2 之間）。 針對傳回預設選擇的GET_DEF要求（也就是實作特定），如果串流介面也打算以一般用途使用（例如，在臉部驗證目的之外），則 D0 應預設在該串流介面上設定為 1：否則，預設應將 D1 或 D2 （但不是兩者）設定為 1。 GET_DEF/GET_CUR要求輸出應包含GET_MAX要求輸出中列出的所有串流介面信息，不過，SET_CUR要求只能包含GET_MAX要求輸出中列出的串流介面子集。

範例：

讓我們假設相機有四個視訊串流介面，數字分別為0x03、0x05、0x08和0x0b，其中視訊串流介面0x05會產生 RGB 數據，其餘三個視訊串流介面會產生 IR 數據。 在產生 IR 數據的串流介面中，讓我們假設串流介面0x03和0x0b都能夠 D1，但串流介面0x03也能夠 D0。 在此範例中，臉部驗證控件只適用於編號為 0x03 和 0x0b的串流介面，因此只有這些介面會出現在要求中。

GET_MAX要求的輸出應如下：

GET_DEF要求的輸出應如下：

SET_CUR將串流介面上的設定0x03變更為 D1 的要求如下：

上述SET_CUR要求之後GET_CUR要求的輸出應如下所示：

2.2.2.7 相機 Extrinsics 控件

此控件可讓主機軟體取得與視訊控制介面相關聯之視訊串流介面上端點的相機外切數據。 因此，針對每個端點取得的數據會顯示為對應數據流屬性存放區上的屬性MFStreamExtension_相機 Extrinsics（使用 IMFDeviceTransform：：GetOutputStreamAttributes 呼叫取得）。

GET_RES、GET_MIN、GET_MAX、GET_CUR要求應報告 欄位 bNumEntries 設定為 0，因此沒有其他欄位。

GET_DEF要求應列出具有可用外向資訊的所有端點。

範例：

假設相機有三個視訊串流介面，其中包含數位0x03、0x05和0x08，其中視訊串流介面0x05除了支援所有視訊串流介面支持的視訊擷取之外，還支援使用方法 2 進行影像擷取。 在這些串流介面中，讓我們假設串流介面0x05和0x08有外星資訊，而串流介面0x03沒有可用的外星資訊。

在此範例中，GET_DEF要求的輸出應如下：

2.2.2.8 相機 內建控件

此控件可讓主機軟體取得與視訊控制介面相關聯之視訊串流介面上端點的相機內建數據。 因此，針對每個端點取得的數據會顯示為對應數據流屬性存放區上的屬性MFStreamExtension_Pinhole相機 Intrinsics（使用 IMFDeviceTransform：：GetOutputStreamAttributes 呼叫取得）。

GET_RES、GET_MIN、GET_MAX、GET_CUR要求應報告 欄位 bNumEntries 設定為 0，因此沒有其他欄位。

GET_DEF要求應列出具有內建資訊的所有端點。

範例：

假設相機有三個視訊串流介面，其中包含數位0x03、0x05和0x08，其中視訊串流介面0x05除了支援所有視訊串流介面支持的視訊擷取之外，還支援使用方法 2 進行影像擷取。 在這些串流介面中，讓我們假設串流介面0x05和0x08具有可用的內建資訊，而串流介面0x03沒有可用的內建資訊。

在此範例中，GET_DEF要求的輸出應如下：

2.2.2.9 元數據控件

此控制器軟體查詢和控制相機所產生的元數據。 這是全域控件，會影響與影片控制介面相關聯之所有視訊串流介面上的所有端點。

此控件會由相機驅動程序對應至 KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA 。

如果韌體支援SET_CUR要求，則適用下列專案：

• GET_MIN，GET_DEF要求應報告欄位 dwValue 設定為 0。

• GET_RES要求應將字段 dwValue 報告為與GET_MAX要求所報告的相同值。

• 當收到SET_CUR要求時 ，dwValue 設定為 0 時，相機不得產生任何元數據。 當收到 SET_CUR要求時，dwValue 設定為與GET_MAX要求所報告的值相同時，相機可以產生元數據，而且這類元數據的大小不能超過 任何畫面的 dwValue 。

如果韌體不支援SET_CUR要求，則適用下列專案：

• GET_MIN，GET_DEF要求應將欄位 dwValue 報告為GET_MAX要求所報告的相同值。

• GET_RES要求應報告欄位 dwValue 設定為 0。

• 相機可以產生元數據，而且這類元數據的總大小不能超過 dwValue - 如GET_MAX要求所報告 - 比任何畫面的 UsbVideoHeader 元數據承載大小少 1024 位元組。

• UsbVideoHeader 元數據承載是 sizeof（KSCAMERA_METADATA_ITEMHEADER） + sizeof（KSTREAM_UVC_METADATA） 或 24 個字節。

產生的元數據應符合第 2.2.3 節中所述的 Microsoft 標準格式元數據。

2.2.2.10 IR 火炬控制

此控件為 IR LED 硬體提供彈性的方法，可報告其可控制的程度，並提供控制它的能力。 這是一種全域控件，可藉由調整連接到相機的 IR 燈，影響與視訊控制介面相關聯之所有視訊串流介面上所有端點的全域控件。

此控件會由相機驅動程式對應至 KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE 。

適用下列專案：

• GET_LEN要求應回報值為8。

• GET_INFO要求應回報值為 3。 這個值表示支援GET_CUR和SET_CUR的同步控件。

• GET_MIN要求應報告欄位 dwMode 設定為 0，而 dwValue 設定為指出最小功率的值。 電源等級 0 可能表示 OFF，但最低操作電源等級不需要 0。

• GET_RES要求應報告字段 dwMode 設定為 0， 而 dwValue 設定為小於或等於 GET_MAX（dwValue） – GET_MIN（dwValue） 的數位，因此GET_MAX（dwValue） - GET_MIN（dwValue） 可由該值平均除。 dwValue 不可以是零 （0）。

• GET_MAX要求應報告欄位 dwMode 集合，其中設定為位 D[0-2] 來識別此控件的功能。 dwMode 必須設定位 D0，表示支援 OFF，而且必須至少有一個其他位集，支援使用中狀態。 dwValue 必須設定為表示一般電源的值。

• GET_DEF要求應報告欄位 dwMode 設定為預設模式，系統應該在串流開始之前處於中狀態。 dwMode 必須設定為 2 （ON） 或 4 （交替）。 dwValue 應該設定為通常用於FaceAuth控件的電源等級。 dwValue 是由製造商所定義。

• GET_CUR要求應報告欄位 dwMode 設為目前的操作模式，並將 dwValue 設定為目前的照明。

• 收到SET_CUR要求時，IR 火炬會使用要求的作業模式，將照明設定為比例的強度。

IR Torch 必須針對每個畫面發出 MF_CAPTURE_METADATA_FRAME_ILLUMINATION 屬性。 它可透過裝置 MFT 或 從相機的元數據承載中包含MetadataId_FrameIllumination 屬性來提供此功能。 請參閱 2.2.3.4.4 一節。

此元數據的唯一用途是指出框架是否亮起。 這是 KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE DDI 和 2.2.6 一節中定義的MSXU_FACE_AUTHENTICATION_CONTROL所需的相同元數據。

2.2.2.11 數字視窗控件

數字視窗會指定相機串流時相機的檢視和縮放欄位。 此控件可能是 Pan、Tilt 和 Zoom 的替代專案。 此控件僅適用於相機主動串流時。

此控制項可供所有類型的相機使用，且與串流媒體類型無關。

此控制件可讓主機軟體查詢和控制與相機相關聯的數字視窗。

這是全域控件，會影響與影片控制介面相關聯之所有視訊串流介面上的所有端點。 它會調整 ISP 所使用的像素數據來源。 這包括方法 2 和方法 3 仍然擷取針腳。

此控件會對應至收件匣相機驅動程式KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW。

適用下列專案：

• GET_LEN要求應報告值為16。

• GET_INFO要求應回報值為 3。 這個值表示支援GET_CUR和SET_CUR的同步控件。

• GET_MIN要求應報告欄位 dwMode 設定為 0、 OriginX 和 OriginY 設定為 0.0，而 WindowSize 設定為 1.0。 此要求目前未使用。

• GET_RES要求應報告欄位 dwMode 設定為 0、OriginX 和 OriginY 設定為 0.0，而 WindowSize 設定為 1.0。 此要求目前未使用。

• GET_MAX要求應報告欄位 dwMode set，其中已設定位 D0 以識別此控制件的功能。 值為 0 表示只支援手動模式。 值為 1 表示支援自動臉部框架模式。 不過，這些欄位的其餘部分未使用，但建議 將 OriginX 和 OriginY 設定為 0.0，並將 WindowSize 設定為 1.0。

• GET_DEF要求應報告欄位 dwMode 設定為 0、OriginX 和 OriginY 設定為 0.0，而 WindowSize 設定為 1.0。 這一律為默認視窗。

• GET_CUR要求應報告欄位 dwMode 設定為目前的作業模式， OriginX、 OriginY 和 WindowSize 描述目前的數字視窗。

• 收到SET_CUR要求時，相機會調整其視野，以符合選取的作業模式和數字視窗。

• 如果選取自動臉部框架模式，相機會選取完全包含場景中主宰臉部的視窗，並 忽略傳入的 OriginX、 OriginY 和 WindowSize 。 如果找不到臉部，則會使用默認視窗。

• 數字視窗的任何變更都必須反映在每個範例的元數據承載中。

• 數字窗口的變更可能不會立即生效，但控件應該立即回應。 數位視窗的變更必須在框架的元數據承載生效后立即回報。

2.2.2.12 數字窗口組態控件

數字視窗設定 Caps 控制項會指定相機的縮放限制，指定所有可用解析度。 解析度與媒體類型無關，因此兩種媒體類型廣告相同的顯示解析度會合併成一項功能。

由於控制端點的大小限制，此控件最多可以描述 1820 個唯一的解析度。

如果數字視窗控制件也存在，則此控件必須隨時可供報告。

此控件會對應至收件匣相機驅動程式KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW_CONFIGCAPS。

適用下列專案：

• GET_LEN要求應報告承載的整個大小。 承載大小必須是 36 的倍數，因為每個解析度定義長度為 36 個字節。

• GET_INFO要求應報告 1。 這個值表示只支援GET_CUR的同步控制項。

• GET_CUR要求應報告功能陣列。 功能結構的欄位定義於上方。

• GET_MIN、GET_MAX、GET_RES和GET_DEF要求未使用，但應該傳回與GET_CUR相同的值。

• 不支援SET_CUR要求。

2.2.2.13 視訊 HDR 控件

此控制項可讓主機軟體指定相機是否支持視訊 HDR。 此控件的支援表示相機能夠盡最大努力執行視訊 HDR。 如果相機不支持視訊 HDR，則它不得實作此控件。

此控件會由相機驅動程序對應至 KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR 。

適用下列專案：

• GET_LEN要求應報告承載的整個大小（例如 4 個字節）。

• GET_INFO要求應回報值 3。 這個值表示支援GET_CUR的同步控件，SET_CUR。

• GET_CUR要求應報告欄位 dwMode 設定為目前的作業模式。

• GET_DEF應將 dwMode 設定為 OFF （0）。

• GET_MAX要求應公告對可用作業模式的支援：[1（ON/OFF）、3（ON/OFF/Auto）]。 此控件必須支援 ON （1）。

• GET_MIN和GET_RES要求應報告 0。

• SET_CUR要求應將模式設定為 OFF （0）、ON （1） 或 AUTO （2）。

2.2.2.14 幀速率節流控制

此控制項可讓主機軟體指定相機是否支援 Framerate 節流。

此控件僅適用於相機主動串流時。 若要主動串流，表示預覽或記錄釘選必須位於KSSTATE_RUN中，且能夠傳遞畫面。 如果數據流不在作用中，則此控件應該傳回STATUS_INVALID_DEVICE_STATE。

即使這是篩選範圍控件，幀速率控件也不應該影響相片釘選或無 RGB 串流，例如 IR/深度。 此外，當幀速率節流生效時，也應該據以調整取樣持續時間。

此控件會由相機驅動程序對應至 KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE 。

適用下列專案：

• GET_LEN要求應報告承載的整個大小（例如 20 個字節）。 

• GET_INFO要求應回報值 3。 這個值表示支援GET_CUR的同步控件，SET_CUR。 

• GET_CUR要求應將字段 dwMode 設定為目前的作業模式，並將 scaleFactorPercentage 設定為目前的 scaleFactor 值。 最小值、最大值和步驟應該回報如上表所述的值。

• GET_DEF的 dwMode 設定為 OFF（0）、scaleFactorPercentage=100、Min 設定為預設值最小值、最大值設定為 100，並將步驟設定為預設步驟值。 製造商應該定義 min 和 step 的值，但應遵循上表中所述的指導方針。

• GET_ MAX 要求應公告對可用作業模式的支援，並將報告值 1 [ ON |OFF ]。 此控件必須同時支援 ON 和 OFF。 最小值、最大值、步驟和 scaleFactorPercentage 可以設定為預設值。

• GET_MIN和GET_RES要求應報告 0。 

• SET_CUR要求應將模式設定為 OFF（0），ON（1）。 如果 dwMode 設定為 ON，則 scaleFactorPercentage 應該生效。 針對 OFF 和 ON 案例，scaleFactorPercentage 必須有效，如上表所述。

2.2.2.15 檢視 2 組態控件的欄位

View 2 元件的欄位會將支援的對角線檢視度值欄位指定為值的陣列。 所有支援的值都必須在理論最小值和最大值、1 度 - 360 度的範圍內。

如果裝置想要支持連續的檢視字段值，它必須報告所有支援的值。 例如，如果裝置想要從85度 - 60度支援對角線檢視欄位，且步驟大小為1的60度，則此控件必須報告值數組[85， 84， 83， 83， 82， ...， 62， 61， 60]。

當檢視欄位 2 控制件存在時，此控制項必須可供報告功能。

這是同步篩選層級控件。

此控件會對應至相機驅動程式KSPROPERTY_CAMERACONTROL_EXTENDED_ FIELDOFVIEW2_CONFIGCAPS。

適用下列專案：

• GET_LEN要求應報告承載的整個大小。

• GET_INFO要求應報告 1。 這個值表示只支援GET_CUR的同步控制項。

• GET_CUR要求應以遞減順序報告包含預設FoV和所支援FoV值數位資料。 結構的欄位定義於上方。

• GET_DEF要求應報告與GET_CUR相同。

• GET_MIN、GET_MAX和GET_RES要求未使用，但應該傳回與GET_CUR相同的值。

• 不支援SET_CUR要求。

View 值的欄位必須依遞減順序排列，例如，最寬的檢視欄位是第一個，最窄的是最後一個。

2.2.2.16 檢視 2 控件的欄位

此控件會指定相機在串流時所使用的基底視野。 此控件可以在串流之前或期間套用。

此控制項可供所有類型的相機使用，且與串流媒體類型無關。

此控件可讓主機軟體查詢和控制與相機相關聯的檢視欄位。

這是全域控件，會影響與影片控制介面相關聯之所有視訊串流介面上的所有端點。 它會調整 ISP（圖像訊號處理器）所使用的圖元（或感測器）數據來源。 這包括方法 2 和方法 3 仍然擷取針腳。

這是同步篩選層級控件。

此控件會對應至相機驅動程式KSPROPERTY_CAMERACONTROL_EXTENDED_ FIELDOFVIEW2。

適用下列專案：

• GET_LEN要求應回報值為 4。

• GET_INFO要求應報告 3。 這個值表示支援GET_CUR和SET_CUR的同步控件。

• GET_MIN要求應報告欄位 dwValue 設定為最低支援的檢視欄位值。

• GET_RES要求應報告欄位 dwValue set 0。 此要求目前未使用。

• GET_MAX要求應將字段 dwValue 設定為支援的 [檢視字段] 值上限。

• GET_DEF要求應將字段 dwValue 設定為預設的 [檢視字段] 值。

• GET_CUR要求應將字段 dwValue 設定為目前的檢視值字段。

• 收到SET_CUR要求時，相機會設定其檢視字段以符合指定的 dwValue。

• 如果相機實作CT_ZOOM_RELATIVE_CONTROL和/或CT_ZOOM_ABSOLUTE_CONTROL，則呼叫 MSXU_CONTROL_FIELDOFVIEW2 SET_CUR 時，這些控件應重設為預設值。

如果相機實作MSXU_CONTROL_DIGITALWINDOW，它應該會在設定新的 [檢視字段] 值時反映窗口變更。 反之亦然，檢視領域應反映透過數字視窗所做的變更。 如需詳細資訊，請參閱KSPROPERTY_CAMERACONTROL_EXTENDED_ FIELDOFVIEW2。

2.2.3 元數據

標準格式框架元數據的設計是以 Windows 10 的 UVC 自定義元數據設計為基礎。 在 Windows 10 中，使用相機驅動程式的自定義 INF 支援 UVC 的自定義元數據（注意：相機驅動程式可以根據 Windows USBVIDEO.SYS，但指定的硬體需要自定義 INF 才能通過元數據）。 如果 MetadataBufferSizeInKB<PinIndex> 登錄專案存在且非零，則該釘選支援自定義元數據，且值表示用於元數據的緩衝區大小。 欄位 <PinIndex> 會指出視訊釘選索引的 0 型索引。

在 Windows 10 版本 1703 中，數位相機驅動程式可以包含下列 AddReg 專案，以發出 Microsoft 標準格式元數據的支持訊號：

StandardFormatMetadata<PinIndex>： REG_DWORD： 0x0 （NotSupported） 至 0x1 （支援）

DevProxy 會讀取此登錄機碼，並通知 UVC 驅動程式元數據是標準格式，方法是在 KSSTREAM_METADATA_INFO 結構的 Flags 字段中設定旗標KSSTREAM_METADATA_INFO_FLAG_STANDARDFORMAT。

2.2.3.1 Microsoft Standard 格式元數據

Microsoft 標準格式元數據是下列結構的一或多個實例：

typedef struct tagKSCAMERA_METADATA_ITEMHEADER {
    ULONG MetadataId;
    ULONG Size; // Size of this header + metadata payload following
} KSCAMERA_METADATA_ITEMHEADER, *PKSCAMERA_METADATA_ITEMHEADER;

MetadataId 欄位會由下列列舉定義的標識碼填入，其中包含定義完善的標識碼和自定義標識元（identifiers >= MetadataId_Custom_Start）。

typedef enum {
    MetadataId_Standard_Start = 1,
    MetadataId_PhotoConfirmation = MetadataId_Standard_Start,
    MetadataId_UsbVideoHeader,
    MetadataId_CaptureStats,
    MetadataId_CameraExtrinsics,
    MetadataId_CameraIntrinsics,
    MetadataId_FrameIllumination,
    MetadataId_Standard_End = MetadataId_FrameIllumination,
    MetadataId_Custom_Start = 0x80000000,
} KSCAMERA_MetadataId;

[大小] 欄位設定為 sizeof（KSCAMERA_METADATA_ITEMHEADER） + sizeof（元數據承載）。

2.2.3.2 來自 USB 視訊畫面封包的韌體產生的標準格式元數據

在透過UVC傳輸以畫面為基礎的視訊期間，視訊畫面會封包成一系列封包，每個封包前面都有UVC承載標頭。 每個 UVC 承載標頭是由 USB 視訊類別驅動程式框架型承載規格所定義：

Payload 標頭

以下是 Frame 型格式之承載標頭格式的描述。

HLE （標頭長度） 欄位

標頭長度欄位元段會指定標頭的長度，以位元組為單位。

位欄位標頭欄位

FID：框架識別碼

• 此位會在每個畫面開始界限上切換，並維持框架其餘部分的常數。

EOF：框架結尾

• 此位表示視訊畫面的結尾，並設定在屬於框架的最後一個視訊範例中。 此位的使用是一種優化，可減少框架傳輸完成時的延遲，而且是選擇性的。

PTS：簡報時間戳

• 設定時，這個位表示 PTS 欄位是否存在。

SCR：來源時鐘參考

• 設定時，這個位會指出 SCR 欄位是否存在。

RES：保留。

• 請將 設為 0。

STI：仍然影像

• 設定時，這個位會將視訊範例識別為屬於靜止影像。

ERR：錯誤位

• 設定時，這個位表示裝置串流發生錯誤。

EOH：標頭結尾

• 當設定時，這個位表示 BFH 字段的結尾。

PTS：簡報時間戳，大小：4 位元組，值：數位

• 當 PTS 位在 BFH[0] 欄位中設定時，就會顯示 PTS 欄位。 請參閱視訊裝置的USB裝置類別定義中的 一節2.4.3.3 >。

typedef struct tagKSCAMERA_METADATA_CAPTURESTATS {
    KSCAMERA_METADATA_ITEMHEADER Header;
    ULONG Flags;
    ULONG Reserved;
    ULONGLONG ExposureTime;
    ULONGLONG ExposureCompensationFlags;
    LONG ExposureCompensationValue;
    ULONG IsoSpeed;
    ULONG FocusState;
    ULONG LensPosition; // a.k.a Focus
    ULONG WhiteBalance;
    ULONG Flash;
    ULONG FlashPower;
    ULONG ZoomFactor;
    ULONGLONG SceneMode;
    ULONGLONG SensorFramerate;
} KSCAMERA_METADATA_CAPTURESTATS, *PKSCAMERA_METADATA_CAPTURESTATS;

#define KSCAMERA_METADATA_CAPTURESTATS_FLAG_EXPOSURETIME            0x00000001
#define KSCAMERA_METADATA_CAPTURESTATS_FLAG_EXPOSURECOMPENSATION    0x00000002
#define KSCAMERA_METADATA_CAPTURESTATS_FLAG_ISOSPEED                0x00000004
#define KSCAMERA_METADATA_CAPTURESTATS_FLAG_FOCUSSTATE              0x00000008
#define KSCAMERA_METADATA_CAPTURESTATS_FLAG_LENSPOSITION            0x00000010
#define KSCAMERA_METADATA_CAPTURESTATS_FLAG_WHITEBALANCE            0x00000020
#define KSCAMERA_METADATA_CAPTURESTATS_FLAG_FLASH                   0x00000040
#define KSCAMERA_METADATA_CAPTURESTATS_FLAG_FLASHPOWER              0x00000080
#define KSCAMERA_METADATA_CAPTURESTATS_FLAG_ZOOMFACTOR              0x00000100
#define KSCAMERA_METADATA_CAPTURESTATS_FLAG_SCENEMODE               0x00000200
#define KSCAMERA_METADATA_CAPTURESTATS_FLAG_SENSORFRAMERATE         0x00000400

typedef struct tagKSCAMERA_METADATA_FRAMEILLUMINATION {
    KSCAMERA_METADATA_ITEMHEADER Header;
    ULONG Flags;
    ULONG Reserved;
} KSCAMERA_METADATA_FRAMEILLUMINATION, *PKSCAMERA_METADATA_FRAMEILLUMINATION;

#define KSCAMERA_METADATA_FRAMEILLUMINATION_FLAG_ON 0x00000001

KSCAMERA_METADATA_FRAMEILLUMINATION.Header.MetadataId = MetadataId_FrameIllumination;
KSCAMERA_METADATA_FRAMEILLUMINATION.Header.Size = 16; // 4 ULONG variables in total inside the structure
KSCAMERA_METADATA_FRAMEILLUMINATION.Flags = KSCAMERA_METADATA_FRAMEILLUMINATION_FLAG_ON;
KSCAMERA_METADATA_FRAMEILLUMINATION.Reserved = 0;

typedef struct
{
    ULONG       PresentationTimeStamp;
    ULONG       SourceClockReference;
    union
    {
        struct
        {
            USHORT    Counter : 11;
            USHORT  Reserved : 5;
        };
        USHORT    SCRToken;
    };
    USHORT      Reserved0;
    ULONG       Reserved1;
} KSSTREAM_UVC_METADATATYPE_TIMESTAMP, *PKSSTREAM_UVC_METADATATYPE_TIMESTAMP;

typedef struct {
    KSSTREAM_UVC_METADATATYPE_TIMESTAMP StartOfFrameTimestamp;
    KSSTREAM_UVC_METADATATYPE_TIMESTAMP EndOfFrameTimestamp;
} KSSTREAM_UVC_METADATA, *PKSSTREAM_UVC_METADATA;