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

  • [アーティクル]

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

カメラ ミニドライバーの CamAllocateBandwidth コールバック関数は、USB ビデオ ストリーミング インターフェイス内の適切な代替設定を選択し、ストリーミングするデバイスを準備します。

構文

PCAM_ALLOCATE_BW_ROUTINE PcamAllocateBwRoutine;

NTSTATUS PcamAllocateBwRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PULONG RawFrameLength,
  PVOID Format
)
{...}

パラメーター

BusDeviceObject

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

DeviceContext

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

RawFrameLength

パケット ストリームからの生フレーム データのサイズをバイト単位で指定します。

Format

このストリームに関連付けられている KS_DATAFORMAT_VIDEOINFOHEADER 構造体へのポインター。

戻り値

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

注釈

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

USBCAMD は、等時性ビデオ キャプチャ ストリームが開始される直前に、カメラ ミニドライバーの CamAllocateBandwidth コールバック関数を呼び出します。 これは、 Run コマンドに関連して呼び出されます。

通常、この関数は USBCAMD_SelectAlternateInterface サービスを呼び出して、正しい代替インターフェイスを選択し、ビデオのストリーミングを準備します。

この関数は必須です。

要件

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

こちらもご覧ください

CamAllocateBandwidthEx

KS_DATAFORMAT_VIDEOINFOHEADER

USBCAMD_SelectAlternateInterface