Skip to content

Latest commit

 

History

History
76 lines (58 loc) · 2.58 KB

nc-poscx-evt_pos_cx_device_remote_claim.md

File metadata and controls

76 lines (58 loc) · 2.58 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NC:poscx.EVT_POS_CX_DEVICE_REMOTE_CLAIM
EVT_POS_CX_DEVICE_REMOTE_CLAIM (poscx.h)
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.
pos\evt_pos_cx_device_remote_claim.htm
pos
02/23/2018
EVT_POS_CX_DEVICE_REMOTE_CLAIM callback function
EVT_POS_CX_DEVICE_REMOTE_CLAIM, EVT_POS_CX_DEVICE_REMOTE_CLAIM callback, EvtPosCxDeviceRemoteClaim, EvtPosCxDeviceRemoteClaim callback function, pos.evt_pos_cx_device_remote_claim, poscx/EvtPosCxDeviceRemoteClaim
poscx.h
Poscx.h
Windows
Windows
EVT_POS_CX_DEVICE_REMOTE_CLAIM
poscx/EVT_POS_CX_DEVICE_REMOTE_CLAIM
APIRef
kbSyntax
UserDefined
poscx.h
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

-param device [in]

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

-param 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.

-returns

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