функция обратного вызова 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 вызывает функцию обратного вызова CamRestoreState мини-драйвера в контексте запроса SRB_CHANGE_POWER_STATE, когда состояние питания переключится на Вкл. (D3–D0).

USBCAMD игнорирует возвращаемое значение из CamRestoreState мини-драйвера.

CamRestoreState вызывается в обеих версиях USBCAMD 1.0 и 2.0.

Эта функция является необязательной.

Сведения о CamSaveState

USBCAMD версии 1.0 вызывает CamSaveState мини-драйвера в контексте запроса SRB_CHANGE_POWER_STATE, где состояние питания от ON до OFF (D0 до D3).

USBCAMD игнорирует возвращаемое значение функции обратного вызова CamSaveState мини-драйвера.

CamSaveState вызывается в usbCAMD версии 1.0 и 2.0.

Эта функция является необязательной.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в версиях операционной системы Windows до Windows XP.
Целевая платформа	Персональный компьютер
Верхняя часть	usbcamdi.h (включая Usbcamdi.h)

См. также раздел

SRB_CHANGE_POWER_STATE