USBCAMD_InitializeNewInterface関数 (usbcamdi.h)

USBCAMD_InitializeNewInterface 関数は、ストリーム クラス ドライバーと USB バス ドライバーで正常に動作するようにカメラ ミニドライバーを構成するために必要なすべての情報を USBCAMD に提供します。

構文

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 バージョン 2.0 で使用するUSBCAMD_VERSION_200値に設定する必要があります。

[in] CamControlFlag

USBCAMD とカメラ ミニドライバーの対話方法を指定します。 カメラ ミニドライバーは、この値を次の 1 つ以上に設定する必要があります。

旗	意味
USBCAMD_CamControlFlag_NoVideoRawProcessing	カメラ ミニドライバーがビデオを操作する必要がない場合は、USBCAMD_CamControlFlag_NoVideoRawProcessingを設定する必要があります。 これにより、1 つのバッファー コピーが削除されます。
USBCAMD_CamControlFlag_NoStillRawProcessing	カメラ ミニドライバーが静止画像の未加工フレームで操作する必要がない場合は、USBCAMD_CamControlFlag_NoStillRawProcessing ビットを設定して 1 つのバッファー コピーを排除する必要があります。
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 によってのみ呼び出されます。

USBCAMD_InitializeNewInterface 関数は、SRB_INITIALIZE_DEVICE 要求を受信したときにカメラ ミニドライバーによって呼び出される必要があります。

必要条件

要件	価値
ターゲット プラットフォーム の	デスクトップ
ヘッダー	usbcamdi.h (Usbcamdi.h を含む)
ライブラリ	Usbcamd2.lib

関連項目

SRB_INITIALIZE_DEVICE

USBCAMD_DEVICE_DATA2