PCAM_CONFIGURE_ROUTINE コールバック関数 (usbcamdi.h)

[アーティクル]
02/29/2024

[CamConfigure はサポートされていないため、今後変更または使用できない可能性があります。代わりに、 CamConfigureEx を使用します。 ]

カメラミニドライバーの CamConfigure コールバック関数は、等時性ストリーミングインターフェイスを構成します。

構文

PCAM_CONFIGURE_ROUTINE PcamConfigureRoutine;

NTSTATUS PcamConfigureRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PUSBD_INTERFACE_INFORMATION Interface,
  PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  PLONG DataPipeIndex,
  PLONG SyncPipeIndex
)
{...}

パラメーター

BusDeviceObject

USB ハブによって作成されたカメラミニドライバーのデバイスオブジェクトへのポインター。

DeviceContext

カメラミニドライバーのデバイスコンテキストへのポインター。

Interface

SELECT_INTERFACE URB 要求の適切な値で初期化されたUSBD_INTERFACE_INFORMATION構造体へのポインター。このインターフェイス構造は、デバイス上の 1 つの等時性インターフェイスに対応します。

ConfigurationDescriptor

このデバイスの初期化されたUSB_CONFIGURATION_DESCRIPTOR へのポインター。

DataPipeIndex

データパイプのインデックスを示す値へのポインター。カメラミニドライバーは、戻る前にこの値を入力する必要があります。

SyncPipeIndex

必要に応じて、同期パイプのインデックスを示す値へのポインター。カメラミニドライバーは、戻る前にこの値を入力する必要があります。

戻り値

CamConfigure は、STATUS_SUCCESSまたは適切なエラーコードを返します。

注釈

元の USBCAMD との下位互換性を維持する必要があるカメラミニドライバーは、 USBCAMD_DEVICE_DATA 構造体とそれに関連付けられているコールバック関数 (つまり、"Ex" サフィックスを含まないコールバック関数) を使用する必要があります。

USBCAMD は、カメラミニドライバーの CamConfigure コールバック関数を呼び出して、等時性ストリーミングインターフェイスを構成します。この関数が戻った後、USBCAMD はどのインターフェイスと、アイドル状態に使用する USB ビデオストリーミングインターフェイス内の代替設定を通知できます。

この関数は必須です。