EVT_POS_CX_DEVICE_REMOTE_CLAIM - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers 
// poscx.h

EVT_POS_CX_DEVICE_REMOTE_CLAIM EvtPosCxDeviceRemoteClaim;

NTSTATUS EvtPosCxDeviceRemoteClaim(
  [in] WDFDEVICE device,
  [in] ULONG deviceInterfaceTag
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Edit description on GitHub

Windows Driver Kit DDI reference (nc-poscx-evt_pos_cx_device_remote_claim)

EVT_POS_CX_DEVICE_REMOTE_CLAIM callback function

Description

The EVT_POS_CX_DEVICE_REMOTE_CLAIM callback is called when the device is transitioning from unclaimed to claimed and allows the driver to do additional work. This callback is typically only used with network connected devices that require additional logic for handling ownership transitions.

EVT_POS_CX_DEVICE_REMOTE_CLAIM and EVT_POS_CX_DEVICE_REMOTE_RELEASE add support for remote devices that handle their own claim semantics.

Parameters

device [in]

A handle to a framework device object that represents the device.

deviceInterfaceTag [in]

An identifier used to specify which interface is being claimed in a multi-function device. For a single-interface device, this value should be 0.

Return value

If the operation is successful, the callback function must return STATUS_SUCCESS or another status value for which NT_SUCCESS(status) equals TRUE.

If the driver is unable to complete the remote claim transaction, it should return STATUS_ACCESS_DENIED so that the failure will bubble up to the application.

See also

EVT_POS_CX_DEVICE_REMOTE_RELEASE

View the official Windows Driver Kit DDI reference

Edit description on GitHub