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 |