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

当电源状态从 OFF 到 ON 时，USBCAMD 在SRB_CHANGE_POWER_STATE请求的上下文中调用微型驱动程序的 CamRestoreState 回调函数， (D3 到 D0) 。

USBCAMD 忽略微型驱动程序的 CamRestoreState 的返回值。

CamRestoreState 由 USBCAMD 版本 1.0 和 2.0 调用。

此函数是可选的。

关于 CamSaveState

USBCAMD 版本 1.0 在SRB_CHANGE_POWER_STATE请求的上下文中调用微型驱动程序的 CamSaveState ，其中电源状态从开到关 (D0 到 D3) 。

USBCAMD 忽略微型驱动程序的 CamSaveState 回调函数的返回值。

CamSaveState 由 USBCAMD 的 1.0 和 2.0 版本调用。

此函数是可选的。

要求	值
最低受支持的客户端	在 Windows XP 之前的 Windows 操作系统版本上可用。
目标平台	桌面
标头	usbcamdi.h (包括 Usbcamdi.h)