функция обратного вызова PCAM_INITIALIZE_ROUTINE (usbcamdi.h)

Статья
02/07/2025

Функция обратного вызова мини-driver камеры инициализирует устройство или выполняет необходимую очистку.

Синтаксис

PCAM_INITIALIZE_ROUTINE PcamInitializeRoutine;

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

Параметры

BusDeviceObject

Указатель на объект устройства мини-driver камеры, созданный USB-концентратором.

DeviceContext

Указатель на контекст устройства мини-driver камеры.

Возвращаемое значение

CamInitialize возвращает STATUS_SUCCESS или соответствующий код ошибки.

Замечания

о CamInitialize

USBCAMD вызывает функцию обратного вызова камеры CamInitialize при первом использовании устройства.

CamInitialize вызывается как исходным USBCAMD, так и USBCAMD2.

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

о CamUnInitialize

USBCAMD вызывает функцию обратного вызова камеры CamUnInitialize при обработке запроса SRB_UNINITIALIZE_DEVICE. Функция CamUnInitialize в версии 1.0 вызывается после того, как пользователь больше не требует периферийного устройства для этого сеанса.

В то время как драйвер класса потока автоматически сбрасывает значения, связанные с мини-driver, этот вызов позволяет мини-driver освободить все определенные ресурсы, используемые во время его работы, например память, используемую для хранения обработанных и декодированных видеокадров.

CamUnInitialize вызывается как версиями 1.0, так и 2.0 USBCAMD.

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	usbcamdi.h (включая Usbcamdi.h)

Поделиться через