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


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

Обратный вызов EVT_POS_CX_DEVICE_REMOTE_CLAIM вызывается при переходе устройства из невостребованного в запрошенный и позволяет драйверу выполнять дополнительную работу. Этот обратный вызов обычно используется только с подключенными к сети устройствами, которым требуется дополнительная логика для обработки переходов владения.

EVT_POS_CX_DEVICE_REMOTE_CLAIM и EVT_POS_CX_DEVICE_REMOTE_RELEASE добавить поддержку удаленных устройств, которые обрабатывают собственную семантику утверждений.

Синтаксис

EVT_POS_CX_DEVICE_REMOTE_CLAIM EvtPosCxDeviceRemoteClaim;

NTSTATUS EvtPosCxDeviceRemoteClaim(
  [in] WDFDEVICE device,
  [in] ULONG deviceInterfaceTag
)
{...}

Параметры

[in] device

Дескриптор объекта устройства платформы, представляющего устройство.

[in] deviceInterfaceTag

Идентификатор, используемый для указания того, какой интерфейс запрашивается на многофункциональном устройстве. Для устройства с одним интерфейсом это значение должно быть равно 0.

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

Если операция выполнена успешно, функция обратного вызова должна возвращать STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS (status) равно TRUE.

Если драйверу не удается завершить транзакцию удаленного утверждения, он должен вернуть STATUS_ACCESS_DENIED, чтобы ошибка перевернулась в приложение.

Требования

Требование Значение
Целевая платформа Windows
Header poscx.h (включая Poscx.h)

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

EVT_POS_CX_DEVICE_REMOTE_RELEASE