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

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

カメラミニドライバーの状態コールバック関数は、以前に保存したデバイスコンテキストの状態を復元するか、現在のデバイスコンテキストの状態を保存します。

構文

PCAM_STATE_ROUTINE PcamStateRoutine;

NTSTATUS PcamStateRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext
)
{...}

BusDeviceObject

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

CamSaveState の場合、この値は NULL にすることができます。

DeviceContext

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

このコールバックルーチンは、STATUS_SUCCESSを返す必要があります。

CamRestoreState について

USBCAMD は、電源状態が OFF から ON (D3 から D0) に向かうときに、SRB_CHANGE_POWER_STATE要求のコンテキストでミニドライバーの CamRestoreState コールバック関数を呼び出します。

USBCAMD は、ミニドライバーの CamRestoreState からの戻り値を無視します。

CamRestoreState は、USBCAMD のバージョン 1.0 と 2.0 の両方によって呼び出されます。

この関数は省略可能です。

CamSaveState について

USBCAMD バージョン 1.0 は、電源状態が ON から OFF (D0 から D3) に向かうSRB_CHANGE_POWER_STATE要求のコンテキストでミニドライバーの CamSaveState を呼び出します。

USBCAMD は、ミニドライバーの CamSaveState コールバック関数からの戻り値を無視します。

CamSaveState は、USBCAMD のバージョン 1.0 と 2.0 の両方によって呼び出されます。

この関数は省略可能です。

要件	値
サポートされている最小のクライアント	Windows XP より前のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	デスクトップ
Header	usbcamdi.h (Usbcamdi.h を含む)