USBCAMD_InitializeNewInterface函式 (usbcamdi.h)
USBCAMD_InitializeNewInterface函式會提供 USBCAMD,並提供所有必要的資訊,以設定相機迷你驅動程式,以便與串流類別驅動程式和 USB 總線驅動程式正確運作。
語法
ULONG USBCAMD_InitializeNewInterface(
[in] PVOID DeviceContext,
[in] PVOID DeviceData,
[in] ULONG Version,
[in] ULONG CamControlFlag
);
參數
[in] DeviceContext
裝置特定內容的指標。
[in] DeviceData
USBCAMD_DEVICE_DATA2 結構的指標。
[in] Version
指定版本資訊。 此值應該設定為值USBCAMD_VERSION_200,以便與USBCAMD 2.0版搭配使用。
[in] CamControlFlag
指定 USBCAMD 和相機迷你驅動程式應該如何互動。 相機迷你驅動程序應該將此值設定為下列一或多個值:
旗標 | 意義 |
---|---|
USBCAMD_CamControlFlag_NoVideoRawProcessing | 如果相機迷你驅動程式不需要在視訊上運作,它應該設定USBCAMD_CamControlFlag_NoVideoRawProcessing。 這可消除一個緩衝區複本。 |
USBCAMD_CamControlFlag_NoStillRawProcessing | 如果相機迷你驅動程式不需要在仍在影像的原始畫面上運作,它應該將USBCAMD_CamControlFlag_NoStillRawProcessing位設定為消除一個緩衝區複本。 |
USBCAMD_CamControlFlag_AssociatedFormat | 如果相機迷你驅動程式針對視訊使用與虛擬仍釘選相同的格式,則應設定USBCAMD_CamControlFlag_AssociatedFormat位。 設定此旗標之後,USBCAMD 不允許以不同於視訊釘選的格式開啟虛擬仍釘選。 只有當虛擬仍然釘選產生與視訊畫面格式相同的畫面時,才應該設定USBCAMD_CamControlFlag_AssociatedFormat位。 |
USBCAMD_CamControlFlag_EnableDeviceEvents | 設定USBCAMD_CamControlFlag_EnableDeviceEvents會將裝置事件公開至串流類別驅動程式和 Microsoft DirectShow。 這可讓 STI 監視器在相機上按下仍然按鈕時啟動仍然影像應用程式。 如果已設定此位 且 按下相機的仍然按鈕,USBCAMD 就會傳送KSEVENT_VIDCAPTOSTI_EXT_TRIGGER事件。 |
傳回值
USBCAMD_InitializeNewInterface 會傳回值USBCAMD_VERSION_200。
備註
只有USBCAMD 2.0版才會呼叫此函式。
接收SRB_INITIALIZE_DEVICE要求時,相機迷你驅動程式必須呼叫USBCAMD_InitializeNewInterface函式。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | usbcamdi.h (包含 Usbcamdi.h) |
程式庫 | Usbcamd2.lib |