共用方式為


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

另請參閱

SRB_INITIALIZE_DEVICE

USBCAMD_DEVICE_DATA2