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	カメラ ミニドライバーが静止画像の未加工フレームで操作する必要がない場合は、1 つのバッファー コピーを排除するために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 でのみ呼び出されます。

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

要件

要件	値
対象プラットフォーム	デスクトップ
Header	usbcamdi.h (Usbcamdi.h を含む)
Library	Usbcamd2.lib

こちらもご覧ください

SRB_INITIALIZE_DEVICE

USBCAMD_DEVICE_DATA2