nf-poscx-poscxretaindevice.md

UID	title	description	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
NF:poscx.PosCxRetainDevice	PosCxRetainDevice function (poscx.h)	PosCxRetainDevice is called to extend the ownership of the device.	pos	03/07/2023	PosCxRetainDevice function	PosCxRetainDevice, PosCxRetainDevice function, pos.poscxretaindevice, poscx/PosCxRetainDevice	poscx.h	Poscx.h	Windows															Windows		PosCxRetainDevice poscx/PosCxRetainDevice	APIRef kbSyntax	HeaderDef	poscx.h	PosCxRetainDevice

-description

PosCxRetainDevice is called to extend the ownership of the device.

-parameters

-param device [in]

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

-param request [in]

A handle to a framework request object that represents the request. This request must come from a WDF IO queue. The caller must always complete the request.

-returns

Possible return values are:

Value	Description
STATUS_SUCCESS	The device was retained successfully.
STATUS_ACCESS_DENIED	The calling thread is not the owner of the device.
STATUS_DEVICE_NOT_READY	The PosCx library was not successfully initialized.